HOUR

📄字数 499

👁️阅读量 加载中...

功能描述

从 expr 中提取小时部分，同 GETHOUR() 函数。

语法格式

HOUR(expr)

输入参数

• expr：要提取的时间日期类型表达式，支持的数据类型包括 DATETIME、DATETIME WITH TIME ZONE、TIME 和 TIME WITH TIME ZONE。

提示

• 因 NULL 无具体的类型，所以当参数为 NULL 时，会产生异常 E10100 候选函数出现多义性，需要手动为参数指定具体的类型，如：HOUR(NULL::DATETIME)；
• 以字符串形式传入日期时间值时，服务端优先匹配 DATETIME 类型，所以参数解析时，按默认的时间格式解析，当参数不符合时间格式时(格式以参数 time_format 配置为准)，执行报错：E19138 时间值常数错误，需要手动指定参数具体的类型，如：HOUR('14:40:22'::TIME) 或 HOUR(CAST('14:40:22+8:00' AS TIME WITH TIME ZONE))。

输出结果

INTEGER 类型，提取出的小时部分，返回值范围 [0,23]，输入参数为 NULL 时，输出结果为 NULL。

示例

-- 提取'2025-07-04 14:40:22'的小时部分
SQL> SELECT HOUR('2025-07-04 14:40:22') FROM dual;

+-------+
| EXPR1 |
+-------+
| 14    |
+-------+