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

Apache Doris 中文参考:MILLISECONDS_ADD

· 52CE 我爱测

输入为 时返回 ,并保持固定的 9 位小数秒精度。结果必须位于返回类型的取值范围内; 的范围为 。

描述

MILLISECONDS_ADD 函数向 DATETIME、TIMESTAMP_NS 或 TIMESTAMPTZ 值中添加指定的毫秒数,并返回相同类型的计算结果。

语法

MILLISECONDS_ADD(`<datetime>`, `<delta>`)

参数

参数 说明
<datetime> 输入的日期时间值,支持 DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ。具体格式请参见 DATETIME 转换、TIMESTAMP_NS 转换和 TIMESTAMPTZ 转换。
<delta> 要添加的毫秒数,类型为 BIGINT,1 秒 = 1,000 毫秒 = 1,000,000 微秒

返回值

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

返回与输入相同的日期时间类型,表示基准时间添加指定毫秒后的结果。

  • 若 <delta> 为负数,函数效果等同于从基准时间中减去对应毫秒数(即 MILLISECONDS_ADD (basetime, -n) 等价于 MILLISECONDS_SUB (basetime, n))。
  • 若输入为 DATE 类型(仅包含年月日),默认其时间部分为 00:00:00.000。
  • 若计算结果超出 DATETIME 类型的有效范围(0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999),抛出异常。
  • 若任一参数为 NULL,返回 NULL。

举例

---增加一毫秒
SELECT MILLISECONDS_ADD('2023-09-08 16:02:08.435123', 1);
+---------------------------------------------------+
| MILLISECONDS_ADD('2023-09-08 16:02:08.435123', 1) |
+---------------------------------------------------+
| 2023-09-08 16:02:08.436123                        |
+---------------------------------------------------+

---毫秒数为负数,对应日期时间减去相应毫秒数
SELECT MILLISECONDS_ADD('2023-05-01 10:00:00.800', -300);
+---------------------------------------------------+
| MILLISECONDS_ADD('2023-05-01 10:00:00.800', -300) |
+---------------------------------------------------+
| 2023-05-01 10:00:00.500000                        |
+---------------------------------------------------+

--- 输入为 DATE 类型(默认时间 00:00:00.000)
SELECT MILLISECONDS_ADD('2023-01-01', 1500);
+--------------------------------------+
| MILLISECONDS_ADD('2023-01-01', 1500) |
+--------------------------------------+
| 2023-01-01 00:00:01.500000           |
+--------------------------------------+

---超出日期时间范围,抛出异常
SELECT MILLISECONDS_ADD('9999-12-31 23:59:59.999', 2000) AS after_add;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation milliseconds_add of 9999-12-31 23:59:59.999000, 2000 out of range

---任意参数为 NULL,返回 NULL
SELECT MILLISECONDS_ADD('2023-10-01 12:00:00.500', NULL) AS after_add;
+-----------+
| after_add |
+-----------+
| NULL      |
+-----------+

---delta 参数支持 BIGINT 范围,超过 INT 上限 (2^31 - 1) 时仍正常计算
SELECT MILLISECONDS_ADD('2023-09-08 16:02:08.435', 2147483648) AS after_add;
+----------------------------+
| after_add                  |
+----------------------------+
| 2023-10-03 12:33:32.083000 |
+----------------------------+

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

资料来源与适用范围

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

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

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