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

Apache Doris 中文参考:SUB_TIME

· 52CE 我爱测

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

描述

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

语法

SUB_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 SUB_TIME('2025-09-19 12:00:00', '01:30:00'); 
+---------------------------------------------+
| SUB_TIME('2025-09-19 12:00:00', '01:30:00') |
+---------------------------------------------+
| 2025-09-19 10:30:00                         |
+---------------------------------------------+

-- 减少时间当第一个参数为 time 类型
SELECT SUB_TIME(cast('12:15:20' as time), '00:10:40'); 
+------------------------------------------------+
| SUB_TIME(cast('12:15:20' as time), '00:10:40') |
+------------------------------------------------+
| 12:04:40                                       |
+------------------------------------------------+   

-- SET time_zone = '+08:00'
select sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123');
+------------------------------------------------------+
| sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123') |
+------------------------------------------------------+
| 2025-10-10 12:59:59.877+08:00                        |
+------------------------------------------------------+
         
-- NULL 参数测试
SELECT SUB_TIME(NULL, '01:00:00');
+----------------------------+
| SUB_TIME(NULL, '01:00:00') |
+----------------------------+
| NULL                       |
+----------------------------+    

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

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

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


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

-- datetime 类型超出范围测试(抛出错误)
SELECT SUB_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 sub_time

SELECT SUB_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 sub_time

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

资料来源与适用范围

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

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

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