CTOD( ) 函数

将字符或数值日期值转换为日期。还可以从字符或数值日期时间值中提取日期并将其作为日期返回。英文“Character to Date”的缩写。

语法

CTOD(字符串/数字 <,格式>)

参数

名称	类型	描述
字符串/数字	字符 数值	要转换为日期或要从中提取日期的域、表达式或字面量值。
格式 可选	字符	字符串/数字的日期格式。对于使用除 YYYYMMDD 和 YYMMDD 以外的任何日期格式的值而言，格式都是必需的，例如 "DD/MM/YYYY"。 说明 如果您将 CTOD 函数与需要格式参数的日期时间值结合使用，请只指定格式的日期部分，而不要指定时间部分。例如： CTOD("31/12/2014 23:59:59", "DD/MM/YYYY") 指定时间部分会阻碍结果出现。

输出

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

示例

基本示例

字符字面量输入

返回 `20141231`，它显示为 31 Dec 2014（假定当前 Analytics 日期显示格式为 DD MMM YYYY）：

CTOD("20141231")

CTOD("31/12/2014", "DD/MM/YYYY")

CTOD("20141231 235959")

数值字面量输入

返回 `20141231`，它显示为 31 Dec 2014（假定当前 Analytics 日期显示格式为 DD MMM YYYY）：

CTOD(20141231)

CTOD(31122014, "DDMMYYYY")

CTOD(20141231.235959)

字符域输入

使用当前 Analytics 日期显示格式，将指定的字符域中的每个值作为日期返回：

CTOD(发票日期, "DD/MM/YYYY")

CTOD(收据时间戳)

数值域输入

使用当前 Analytics 日期显示格式，将指定的数值域中的每个值作为日期返回：

CTOD(到期日期, "DDMMYYYY")

CTOD(付款时间戳)

高级示例

备注

需要日期格式

包含日期或日期时间值的字符域和数值域必须符合下表中的格式。日期时间值可以使用对其数据类型有效的日期、分隔符和时间格式的任意组合。日期必须位于时间前面，并且必须在两者之间使用一个分隔符。

日期或日期时间值的日期部分可以使用 Analytics 支持且对其数据类型有效的任意日期格式，前提是格式正确定义了除 YYYYMMDD 和 YYMMDD 以外的格式。

日期格式	分隔符格式	时间格式
字符域
YYYYMMDD	单个空格	hhmmss hh:mm:ss
YYMMDD	字母 't'	hhmm hh:mm
如果是由格式定义的，则为 Analytics 支持且对数据类型有效的任意日期格式	字母 'T'	hh
		+/-hhmm +/-hh:mm （UTC 偏移量）
		+/-hh （UTC 偏移量）
		说明 请勿在包含 UTC 偏移量数据的主时间格式中单独使用 hh。例如，请避免：hh+hhmm。结果可能不可靠。）
数值域
YYYYMMDD	小数点	hhmmss
YYMMDD		hhmm
如果是由格式定义的，则为 Analytics 支持且对数据类型有效的任意日期格式		hh

其他日期时间转换函数

字符或数值到日期时间转换

函数	描述
CTODT( )	将字符或数值日期时间值转换为日期时间。英文“Character to Datetime”的缩写。
CTOT( )	将字符或数值时间值转换为时间。还可以从字符或数值日期时间值中提取时间并将其作为时间返回。英文“Character to Time”的缩写。

日期时间到字符转换

函数	描述
DATE( )	从指定的日期或日期时间中提取日期并将其以字符串形式返回。还可以返回当前操作系统日期。
DATETIME( )	将日期时间转换为字符串。还可以返回当前操作系统日期时间。
TIME( )	从指定的时间或日期时间中提取时间并将其以字符串形式返回。还可以返回当前操作系统时间。

序列到日期时间转换

函数	描述
STOD( )	将序列日期，即以整数形式表示的日期转换为日期值。英文“Serial to Date”的缩写。
STODT( )	将序列日期时间，即以整数形式表示的日期时间和 24 小时的小数部分转换为日期时间值。英文“Serial to Datetime”的缩写。
STOT( )	将序列时间，即以 24 小时的小数部分形式表示的时间（其中，24 小时等于 1）转换为时间值。英文“Serial to Time”的缩写。