UTOD( ) 函数

将包含一个格式化日期的 Unicode 字符串转换为一个 Analytics 日期值。英文“Unicode to Date”的缩写。

语法

UTOD（字符串 <，区域设置> <，样式>）

参数

名称	类型	描述
字符串	字符	要转换为日期的 Unicode 字符串。 Unicode 字符串可包含日期时间值，但该值的时间部分被忽略。不支持独立的时间值。 字符串必须匹配该日期的区域设置的样式值所需的输入格式。
区域设置 可选	字符	指定输出字符串的语言和区域设置的代码，并且可能指定与特定国家或地区相关联的语言的版本。 例如，"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。如果您尚未指定区域设置，则无法指定样式。 提示 要获得与确定您的输入字符串的预期格式有关的帮助，请执行下列操作之一： 使用 DTOU( ) 函数生成使用该样式和区域设置的示例值。 在命令行中，使用 DISPLAY 命令打印该值： DISPLAY DTOU(`20160909`, "es_MX", 3) 有关特定区域设置中样式的标准日期格式，请参考权威性信息源。

示例

基本示例

字面量输入值

返回 `20141231`，显示为 31 Dec 2014：

UTOD("31 de dezembro de 2014", "pt_BR", 1)

返回 `20141231`，显示为 31 Dec 2014：

UTOD("31 grudnia 2014", "pl", 1)

域输入值

返回发票日期域中的每个 Unicode 字符串的日期等效值：

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

输入使用完整日期样式

返回 `20141231`，显示为 31 Dec 2014（未指定地区标识符）：

UTOD("星期三, 2014 十二月 31", "zh", 0)

返回 `20141231`，显示为 31 Dec 2014（指定了地区标识符）：

UTOD("2014年12月31日星期三", "zh_CN", 0)

输入使用长日期样式

返回 `20141231`，显示为 31 Dec 2014（未指定地区标识符）：

UTOD("2014 十二月 31", "zh", 1)

返回 `20141231`，显示为 31 Dec 2014（指定了地区标识符）：

UTOD("2014年12月31日", "zh_CN", 1)

备注

成功地转换 Unicode 字符串

要将包含日期的 Unicode 字符串成功转换为 Analytics 日期，您必须指定与语言、国家/地区（如果适用）和 Unicode 字符串中的日期样式匹配的区域设置和样式参数。

相关函数

UTOD( ) 是 DTOU( ) 的逆函数，后者可将日期转换为 Unicode 字符串。如果您不确定要为 UTOD( ) 指定哪个国家/地区和样式，您可以使用 DTOU( ) 并试用不同的参数，以便产生与您想要用 UTOD( ) 转换的输入 Unicode 字符串的形式匹配的输出 Unicode 字符串。