TIME( ) 函数
从指定的时间或日期时间中提取时间并将其以字符串形式返回。还可以返回当前操作系统时间。
语法
TIME(<时间/日期时间> <,格式>)
参数
名称 | 类型 | 描述 |
---|---|---|
时间/日期时间
可选 |
日期时间 |
要从中提取时间的域、表达式或字面量值。如果省略该参数,则以格式 hh:mm:ss 返回当前操作系统时间。 |
格式
可选 |
字符 |
要应用于输出字符串的格式,例如 "hh:mm:ss"。如果省略该参数,则使用当前 Analytics 时间显示格式。如果已省略时间/日期时间参数,则无法指定格式。 |
输出
字符。
示例
基本示例
字面量输入值
返回 "23:59:59"(假定 Analytics 时间显示格式为 hh:mm:ss):
TIME(`20141231 235959`)
返回 "11:59 P":
TIME(`20141231 235959`, "hh:mm A")
以 hh:mm:ss 格式(24 小时时钟)的字符串形式返回当前操作系统时间:
TIME()
使用域作为输入值
对于收款时间戳域中的每个值,使用当前 Analytics 时间显示格式返回字符串:
TIME(回执时间戳)
对于收款时间戳域中的每个值,使用指定的时间显示格式返回字符串:
TIME(收款时间戳, "hh:mm:ss")
高级示例
使用 TIME( ) 函数有助于计算特定 Analytics 命令或整个脚本执行所花费的时间。
在您想要计时的命令的紧前面,或者在脚本的开头,指定此行以创建用于存储当前操作系统时间的变量:
ASSIGN Time_started = TIME()
在该命令紧后面,或者在脚本的末尾,指定下列两行。
第一行创建一个变量,该变量在命令或脚本完成后存储操作系统时间。第二行计算完成时间和开始时间之间的差值,并且将结果转换为可读的格式。
提示
您可以双击 CALCULATE 日志条目来查看命令或脚本的已用时间。
ASSIGN Time_finished = TIME() CALCULATE STOT(CTOT(结束时间) - CTOT(开始时间))
如果命令或脚本将越过午夜边界运行,请改用下面的第二行:
CALCULATE `T000000` - (CTOT(开始时间) - CTOT(结束时间))
备注
输出字符串长度
输出字符串的长度始终为 14 个字符。如果指定的输出格式或 Analytics 时间显示格式小于 14 个字符,则使用结尾空格填充输出字符串。
参数详细信息
为时间/日期时间指定的域可以使用任何时间或日期时间格式,前提是域定义正确定义了该格式。
如果您使用格式来控制如何显示输出字符串,则必须使用下表中的格式。您可以使用时间和 AM/PM 格式的任意组合。AM/PM 格式是可选的,并且被放置在最后。
请使用单引号或双引号指定格式。例如:"hh:mm:ss AM"。
时间格式 |
AM/PM 格式 |
示例 |
---|---|---|
hh:mm:ss |
无 24 小时时钟 |
"hh:mm:ss" |
hhmmss |
AM 或 PM 12 小时时钟 |
"hhmmss PM" |
hh:mm |
A 或 P 12 小时时钟 |
"hh:mm A" |
hhmm |
|
|
hh |
|
|
指定时间或日期时间字面值
在为日期/日期时间指定字面量时间或日期时间值时,您必须使用下表中的格式,并且必须将值放在反引号中 — 例如,`20141231 235959`。
在日期或时间的各个部分之间,不要使用任何分隔符,如斜杠 (/) 或冒号 (:)。
-
时间值 - 您可以使用下表列出的任一时间格式。您必须在单独的时间值之前使用分隔符,以使函数能够正确工作。有效分隔符是字母 't' 或字母 'T'。您必须使用 24 小时时钟指定时间。协调世界时 (UTC) 偏移量前面必须带有加号 (+) 或减号 (-)。
-
日期时间值 - 您可以使用日期、分隔符和下表列出的时间格式的任意组合。日期必须位于时间前面,并且您必须在两者之间使用分隔符。有效分隔符是单个空格、字母 't' 或字母 'T'。
格式示例
字面值示例
thhmmss
`t235959`
Thhmm
`T2359`
YYYYMMDD hhmmss
`20141231 235959`
YYMMDDthhmm
`141231t2359`
YYYYMMDDThh
`20141231T23`
YYYYMMDD hhmmss+/-hhmm
(UTC 偏移量)
`20141231 235959-0500`
YYMMDD hhmm+/-hh
(UTC 偏移量)
`141231 2359+01`
说明
请勿在包含 UTC 偏移量数据的主时间格式中单独使用 hh。例如,请避免:hh+hhmm。结果可能不可靠。
相关函数
如果您需要将当前操作系统时间返回为日期时间值,请使用 NOW( ) 而不是 TIME( )。
其他日期时间转换函数
日期时间到字符转换
函数 | 描述 |
---|---|
从指定的日期或日期时间中提取日期并将其以字符串形式返回。还可以返回当前操作系统日期。 |
|
将日期时间转换为字符串。还可以返回当前操作系统日期时间。 |
字符或数值到日期时间转换
函数 | 描述 |
---|---|
将字符或数值日期值转换为日期。还可以从字符或数值日期时间值中提取日期并将其作为日期返回。英文“Character to Date”的缩写。 |
|
将字符或数值日期时间值转换为日期时间。英文“Character to Datetime”的缩写。 |
|
将字符或数值时间值转换为时间。还可以从字符或数值日期时间值中提取时间并将其作为时间返回。英文“Character to Time”的缩写。 |
序列到日期时间转换
函数 | 描述 |
---|---|
将序列日期,即以整数形式表示的日期转换为日期值。英文“Serial to Date”的缩写。 |
|
将序列日期时间,即以整数形式表示的日期时间和 24 小时的小数部分转换为日期时间值。英文“Serial to Datetime”的缩写。 |
|
将序列时间,即以 24 小时的小数部分形式表示的时间(其中,24 小时等于 1)转换为时间值。英文“Serial to Time”的缩写。 |