UTOD( ) 函数

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

说明

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

在使用的日期采用与您的默认安装不同的语言和格式时，请使用此函数。如果您想要转换的字符串属于您的默认语言，请改用 CTOD( )。

语法

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) 有关特定区域设置中样式的标准日期格式，请参考权威性信息源。

名称

类型

描述

字符串

字符

要转换为日期的 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)
```
有关特定区域设置中样式的标准日期格式，请参考权威性信息源。

输出

日期时间。日期值使用当前 Analytics 日期显示格式输出。

示例

基本示例

说明

所有示例都假定当前 Analytics 日期显示格式为 DD MMM YYYY。

在下面的示例中，“中文”("zh") 和“简体中文”("zh_CN") 的区域设置代码匹配不同的输入字符串，并且不可互换。

您还必须指定正确的样式。如果您指定样式 2，则长 Unicode 日期字符串（即，样式为 1）不会返回 Analytics 日期。

字面量输入值

返回 `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 字符串中的日期样式匹配的区域设置和样式参数。