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

Apache Doris 中文参考:ADD_TIME

· 52CE 我爱测

将给定的时间间隔添加到日期时间/时间表达式上。若第二个参数为负数,则等价于从第一个参数中减去该时间间隔。

描述

将给定的时间间隔添加到日期时间/时间表达式上。若第二个参数为负数,则等价于从第一个参数中减去该时间间隔。

语法

ADD_TIME(`<date_or_time_expr>`, `<time>`)

参数

参数 说明
<date_or_time_expr> 参数是合法的日期表达式,支持输入 TIMESTAMPTZ/TIMESTAMP_NS/DATETIME/DATE/TIME 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看 timestamptz的转换, datetime 的转换 和 time的转换
<time> 参数为合法的时间表达式,表示增加到<date_or_time_expr> 上面的时间值,若为负数,则表示减少,支持输入 time 类型

返回值

输入为 TIMESTAMP_NS 时返回 TIMESTAMP_NS,并保持固定的 9 位小数秒精度。结果必须位于返回类型的取值范围内;TIMESTAMP_NS 的范围为 [1677-09-21 00:12:43.145224192, 2262-04-11 23:47:16.854775807]。

返回 <date_or_time_expr> 添加 <time> 时间值之后的结果,根据第一个参数类型返回不同的类型

  • 若第一个参数为 timestamptz 类型,则返回 timestamptz 类型
  • 若第一个参数为 datetime 类型,则返回 datetime 类型
  • 若第一个参数为 time 类型,则返回 time 类型

特殊情况:

  • 若输入参数包含 null ,返回 null
  • 若第一个参数类型为 time 类型,且计算结果超出 time 类型范围,则返回 time 类型最大(最小值)
  • 若第一个参数类型为 datetime 或 timestamptz 类型,且计算结果超出 datetime 类型的范围,则抛出错误

举例

-- 增加时间当第一个参数为 datetime 类型
SELECT ADD_TIME('2025-09-19 12:00:00', '01:30:00'); 
+---------------------------------------------+
| ADD_TIME('2025-09-19 12:00:00', '01:30:00') |
+---------------------------------------------+
| 2025-09-19 13:30:00                         |
+---------------------------------------------+

-- 增加时间当第一个参数为 time 类型
SELECT ADD_TIME(cast('12:15:20' as time), '00:10:40'); 
+------------------------------------------------+
| ADD_TIME(cast('12:15:20' as time), '00:10:40') |
+------------------------------------------------+
| 12:26:00                                       |
+------------------------------------------------+   

-- SET time_zone = '+08:00';
SELECT ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03');
+-----------------------------------------------------------+
| ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03') |
+-----------------------------------------------------------+
| 2025-10-10 17:24:36.123457+08:00                          |
+-----------------------------------------------------------+
         
-- NULL 参数测试
SELECT ADD_TIME(NULL, '01:00:00');
+----------------------------+
| ADD_TIME(NULL, '01:00:00') |
+----------------------------+
| NULL                       |
+----------------------------+    

SELECT ADD_TIME('2025-09-19 12:00:00', NULL); 
+---------------------------------------+
| ADD_TIME('2025-09-19 12:00:00', NULL) |
+---------------------------------------+
| NULL                                  |
+---------------------------------------+

SELECT ADD_TIME(NULL, NULL);
+----------------------+
| ADD_TIME(NULL, NULL) |
+----------------------+
| NULL                 |
+----------------------+                        

-- time 类型超出范围测试(返回最大/最小值)
SELECT ADD_TIME(cast('835:30:00' as time), '21:00:00'); 
+-------------------------------------------------+
| ADD_TIME(cast('835:30:00' as time), '21:00:00') |
+-------------------------------------------------+
| 838:59:59                                       |
+-------------------------------------------------+


SELECT ADD_TIME(cast('-832:30:00' as time), '-31:00:00');   
+---------------------------------------------------+
| ADD_TIME(cast('-832:30:00' as time), '-31:00:00') |
+---------------------------------------------------+
| -838:59:59                                        |
+---------------------------------------------------+       

-- datetime 类型超出范围测试(抛出错误)
SELECT ADD_TIME('9999-12-31 23:59:59', '00:00:01');  
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]datetime value is out of range in function add_time

SELECT ADD_TIME('0000-01-01 00:00:00', '-00:00:01');
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]datetime value is out of range in function add_time

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

资料来源与适用范围

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

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

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