TIME( ) 函数

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

语法

TIME(<时间/日期时间> <,格式>)

参数

输出

字符。

示例

基本示例

字面量输入值

返回 "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")

高级示例

ASSIGN Time_started = TIME()

ASSIGN Time_finished = TIME()
CALCULATE STOT(CTOT(结束时间) - CTOT(开始时间))

CALCULATE `T000000` - (CTOT(开始时间) - CTOT(结束时间))

备注

输出字符串长度

输出字符串的长度始终为 14 个字符。 如果指定的输出格式或 Analytics 时间显示格式小于 14 个字符，则使用结尾空格填充输出字符串。

参数详细信息

为时间/日期时间指定的域可以使用任何时间或日期时间格式，前提是域定义正确定义了该格式。

如果您使用格式来控制如何显示输出字符串，则必须使用下表中的格式。 您可以使用时间和 AM/PM 格式的任意组合。 AM/PM 格式是可选的，并且被放置在最后。

请使用单引号或双引号指定格式。 例如："hh:mm:ss AM"。

指定时间或日期时间字面值

在为日期/日期时间指定字面量时间或日期时间值时，您必须使用下表中的格式，并且必须将值放在反引号中 — 例如，`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( )。

其他日期时间转换函数

日期时间到字符转换

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

序列到日期时间转换