CTOT( ) 函数

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

语法

CTOT(字符串/数字)

参数

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

字符

数值

要转换为时间或要从中提取时间的域、表达式或字面量值。

输出

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

示例

基本示例

字符字面量输入

返回 `t235959`,它显示为 23:59:59(假定当前 Analytics 时间显示格式为 hh:mm:ss):

CTOT("t235959")
CTOT("23:59:59")
CTOT("20141231 235959")

数值字面量输入

返回 `t235959`,它显示为 23:59:59(假定当前 Analytics 时间显示格式为 hh:mm:ss):

CTOT(.235959)
CTOT(0.235959)
CTOT(20141231.235959)

字符域输入

使用当前 Analytics 时间显示格式,将登录时间字符域中的每个值作为时间返回:

CTOT(登录时间)

数值域输入

使用当前 Analytics 时间显示格式,将 Payment_datetime 数值域中的每个值作为时间返回(不带任何日期部分):

CTOT(Payment_datetime)

高级示例

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

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

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

  • 将时间存储为数值数据的数值 Login_time
  • 字面量时间值 09:30:00
SET FILTER TO CTOT(登录时间) > `t093000`

备注

需要日期时间格式

包含时间或日期时间值的字符域和数值域必须符合下表中的格式。

时间值可以使用分隔符和时间格式的任意组合。要使函数正确工作,必须在时间值之前使用一个分隔符,或者必须在时间的各个部分之间使用冒号。

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

如果您想要将字符或数值日期值转换为日期,或者从字符或数值日期时间值中提取日期并将其作为日期返回,请使用 CTOD( ) 函数。

如果您想要将字符或数值日期时间值转换为日期时间,请使用 CTODT( ) 函数。

日期格式

分隔符格式

时间格式

字符域

YYYYMMDD

单个空格

hhmmss

hh:mm:ss

YYMMDD

字母 't'

hhmm

hh:mm

 

字母 'T'

hh

 

 

+/-hhmm

+/-hh:mm

(UTC 偏移量)

 

 

+/-hh

(UTC 偏移量)

 

 

注:

请勿在包含 UTC 偏移量数据的主时间格式中单独使用 hh。例如,请避免:hh+hhmm。结果可能不可靠。)

数值域

YYYYMMDD

小数点

hhmmss

YYMMDD

 

hhmm

 

 

hh

其他日期时间转换函数

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

函数 描述

CTOD( )

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

CTODT( )

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

日期时间到字符转换

函数 描述

DATE( )

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

DATETIME( )

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

TIME( )

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

序列到日期时间转换

函数 描述

STOD( )

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

STODT( )

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

STOT( )

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

ACL 脚本指南 14.1