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。如果您尚未指定日期和区域设置，则无法指定样式。

名称

类型

描述

日期

可选

日期时间

要转换为 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)