HOUR( ) 函数

从指定的时间或日期时间中提取小时并将其以使用 24 小时时钟的数值形式返回。

语法

HOUR(时间/日期时间)

参数

名称 类型 描述
时间/日期时间

日期时间

要从中提取小时的域、表达式或字面量值。

输出

数值。

示例

基本示例

返回 23:

HOUR(`t235959`)
HOUR(`20141231 235959`)

返回 Call_start_time 域中每个值的小时值:

HOUR(Call_start_time)

备注

参数详细信息

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

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

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

     

ACL 脚本指南 14.1