DTOU( ) 函数

将 Analytics 日期值转换为指定语言和区域设置格式的 Unicode 字符串。英文“Date to Unicode”的缩写。

说明

该函数是 Unicode 版的 Analytics 所特有的。非 Unicode 版本不支持此函数。

语法

DTOU(<日期> <,区域设置> <,样式>)

参数

名称 类型 描述
日期

可选

日期时间

要转换为 Unicode 字符串的域、表达式或字面量值。如果省略该参数,则使用当前操作系统日期。

日期可包含日期时间值,但该值的时间部分被忽略。不支持独立的时间值。

您可以指定域或字面量日期值:

  • 可以使用任何日期格式,前提是域定义正确定义了该格式
  • 字面量必须使用 YYYYMMDD 或者 YYMMDD 格式之一,例如 `20141231`

受支持的最小日期值是 1969 年 12 月 31 日。

区域设置

可选

字符

区域设置代码,指定输出字符串的语言,并且可能指定与特定国家或地区相关联的语言版本。

例如,"zh" 指定中文,而 "pt_BR" 指定巴西葡萄牙语。

如果将其省略,则使用您的计算机的默认区域设置。如果指定了语言,而没有指定国家/地区,则使用该语言的默认国家/地区。

如果您尚未指定日期,则无法指定区域设置

如需了解关于区域设置代码的信息,请参见 www.unicode.org

样式

可选

数值

要用于 Unicode 字符串的日期格式样式。该格式样式符合您指定的区域设置的标准:

  • 0 – 完整规范格式,如 "Sunday, September 18, 2016"
  • 1 – 长格式,如 "September 18, 2016"
  • 2 – 中等格式,如 "Sep 18, 2016"
  • 3 – 短数值格式,如 "9/18/16"

如果将其省略,则使用默认值 2。如果您尚未指定日期区域设置,则无法指定样式

输出

字符。

示例

基本示例

字面量输入值

返回 "31 de dezembro de 2014":

DTOU(`20141231`, "pt_BR", 1)

返回 "31 grudnia 2014":

DTOU(`20141231`, "pl", 1)

域输入值

发票日期域中的每个数值日期返回为一个 Unicode 字符串:

DTOU(发票日期, "zh", 1)

输出使用完整日期样式

返回 "星期三, 2014 十二月 31"(不指定地区标识符):

DTOU(`20141231`, "zh", 0)

返回 "2014年12月31日星期三"(指定地区标识符):

DTOU(`20141231`, "zh_CN", 0)

输出使用长日期样式

返回 "2014 十二月 31"(不指定地区标识符):

DTOU(`20141231`, "zh", 1)

返回 "2014年12月31日"(指定地区标识符):

DTOU(`20141231`, "zh_CN", 1)

备注

相关函数

DTOU( ) 是 UTOD( ) 函数的逆函数,后者可将 Unicode 字符串转换为日期。

ACL 脚本指南 14.1