CTODT( ) 函数

将字符或数值日期时间值转换为日期时间。英文“Character to Datetime”的缩写。

语法

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

参数

名称 类型 描述
字符串/数字

字符

数值

要转换为日期时间的域、表达式或字面量值。
格式

可选

字符

字符串/数字的日期格式。对于使用除 YYYYMMDD 和 YYMMDD 以外的任何日期格式作为值的日期部分的值而言,格式都是必需的,例如 "DD/MM/YYYY"

输出

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

示例

基本示例

字符字面量输入

返回 `20141231t235959`,它显示为 31 Dec 2014 23:59:59(假定当前 Analytics 日期和时间显示格式为 DD MMM YYYY 和 hh:mm:ss PM):

CTODT("20141231 235959")
CTODT("31/12/2014 23:59:59", "DD/MM/YYYY hh:mm:ss")

数值字面量输入

返回 `20141231t235959`,它显示为 31 Dec 2014 23:59:59(假定当前 Analytics 日期和时间显示格式为 DD MMM YYYY 和 hh:mm:ss PM):

CTODT(20141231.235959)
CTODT(31122014.235959, "DDMMYYYY.hhmmss")

字符域输入

使用当前 Analytics 日期显示格式,将收款时间戳字符域中的每个值作为日期时间返回:

CTODT(收款时间戳, "DD/MM/YYYY hh:mm:ss")

数值域输入

使用当前 Analytics 日期显示格式,将 Payment_timestamp 数值域中的每个值作为日期时间返回:

CTODT(Payment_timestamp, "DD/MM/YYYY hh:mm:ss")

高级示例

将字符或数值域与日期时间进行比较

使用 CTODT( ) 函数可将日期时间与包含代表日期时间的值的字符或数值域进行比较。

下面的过滤器比较两个值:

  • 将日期时间存储为 DD/MM/YYYYhh:mm:ss 格式的字符数据的字符 Receipt_timestamp
  • 字面量日期时间值 2014 年 7 月 1 日 13:30:00
SET FILTER TO CTODT(Receipt_timestamp, "DD/MM/YYYY hh:mm:ss") < `20140701t133000`

备注

需要日期时间格式

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

值的日期部分可以使用 Analytics 支持且对其数据类型有效的任意日期格式,前提是格式正确定义了除 YYYYMMDD 和 YYMMDD 以外的格式。如果您使用格式,则还必须指定时间格式,该格式必须是出现在下表中的时间格式之一。

Analytics 可自动识别日期时间值的日期和时间部分之间的分隔符,因此无需在格式中指定分隔符。如果您愿意,您可以指定分隔符。

日期格式

分隔符格式

时间格式

字符域

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

其他日期时间转换函数

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

函数 描述

CTOD( )

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

CTOT( )

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

日期时间到字符转换

函数 描述

DATE( )

从指定的日期或日期时间中提取日期并将其以字符串形式返回。还可以返回当前操作系统日期。

DATETIME( )

将日期时间转换为字符串。还可以返回当前操作系统日期时间。

TIME( )

从指定的时间或日期时间中提取时间并将其以字符串形式返回。还可以返回当前操作系统时间。

序列到日期时间转换

函数 描述

STOD( )

将序列日期,即以整数形式表示的日期转换为日期值。英文“Serial to Date”的缩写。

STODT( )

将序列日期时间,即以整数形式表示的日期时间和 24 小时的小数部分转换为日期时间值。英文“Serial to Datetime”的缩写。

STOT( )

将序列时间,即以 24 小时的小数部分形式表示的时间(其中,24 小时等于 1)转换为时间值。英文“Serial to Time”的缩写。

ACL 脚本指南 14.1