大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:HOUR

· 52CE 我爱测

HOUR 函数用于提取日期时间或时间表达式中的小时部分。该函数支持多种时间类型输入,包括 DATE/DATETIME/TIMESTAMP_NS、TIME ,返回对应小时数值。

描述

HOUR 函数用于提取日期时间或时间表达式中的小时部分。该函数支持多种时间类型输入,包括 DATE/DATETIME/TIMESTAMP_NS、TIME ,返回对应小时数值。

对于 DATETIME (如 '2023-10-01 14:30:00'),返回值范围为 0-23(24 小时制)。 对于 TIME 类型(如 '456:26:32'),返回值可超出 24,范围为 [0,838]。

该函数与 mysql 中的 hour 函数 行为一致。

语法

HOUR(`<date_or_time_expr>`)

参数

参数 说明
<date_or_time_expr> 合法的日期或时间表达式,支持 DATE、DATETIME、TIMESTAMP_NS 和 TIME。DATE 输入按 00:00:00 处理。具体格式请查看 datetime 的转换、date 的转换和 time 的转换。

返回值

返回整数类型(INT),表示输入表达式中的小时部分。

  • 对于 DATETIME ,返回 0-23 的整数。
  • 对于 TIMESTAMP_NS,返回 0-23 的整数。
  • 对于 DATE 类型 ,返回 0.
  • 对于 TIME 类型,返回 0 至 838 的整数(与 TIME 类型的范围一致),返回的是绝对值,没有负数。
  • 输入参数为 NULL,返回 NULL

举例

-- 从日期时间中提取小时(24小时制)
select 
    hour('2018-12-31 23:59:59') as last_hour,
    hour('2023-01-01 00:00:00') as midnight,   
    hour('2023-10-01 12:30:45') as noon;     

+-----------+----------+------+
| last_hour | midnight | noon |
+-----------+----------+------+
|        23 |        0 |   12 |
+-----------+----------+------+

-- 从 TIME 类型中提取小时(支持超过24或负数)
select 
    hour(cast('14:30:00' as time)) as normal_hour,     
    hour(cast('25:00:00' as time)) as over_24,
    hour(cast('456:26:32' as time)) as large_hour,     
    hour(cast('-12:30:00' as time)) as negative_hour, 
    hour(cast('838:59:59' as time)) as max_hour,    
    hour(cast('-838:59:59' as time)) as min_hour;    

+-------------+---------+------------+---------------+----------+----------+
| normal_hour | over_24 | large_hour | negative_hour | max_hour | min_hour |
+-------------+---------+------------+---------------+----------+----------+
|          14 |      25 |        456 |            12 |      838 |      838 |
+-------------+---------+------------+---------------+----------+----------+

--- 从 date 类型中提取小时,返回 0
select hour("2022-12-12");
+--------------------+
| hour("2022-12-12") |
+--------------------+
|                  0 |
+--------------------+

select hour('14:30:00') as normal_hour;
+-------------+
| normal_hour |
+-------------+
|          14 |
+-------------+

---输入参数为 NULL ,返回 NULL
mysql> select hour(NULL);
+------------+
| hour(NULL) |
+------------+
|       NULL |
+------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。