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

Apache Doris 中文参考:MINUTES_ADD

· 52CE 我爱测

MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数,并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS、TIMESTAMPTZ类型。

描述

MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数,并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS、TIMESTAMPTZ类型。

该函数与 date_add 函数 和 mysql 的 date-add 函数 使用 MINUTE 为单位的行为一致。

语法

MINUTES_ADD(`<date_or_time_expr>`, `<minutes>`)

参数

参数 说明
<date_or_time_expr> 输入的日期时间值,类型可以是 DATE、DATETIME、TIMESTAMP_NS、TIMESTAMPTZ,具体格式请查看 timestamptz的转换, datetime 的转换, date 的转换,
<minutes> 要增加的分钟数,类型为 BIGINT,可以为正数或负数

返回值

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

返回基准时间<datetime_like_type>添加指定分钟<minutes>后的结果,返回类型与第一个参数类型相关:

  • 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
  • 若第一个参数为 DATETIME, 则返回 DATETIME。

特殊情况:

  • 若 <minutes> 为负数,函数效果等同于从基准时间中减去对应分钟数(即 MINUTES_ADD(date, -n) 等价于 MINUTES_SUB(date, n))。
  • 若输入为 DATE 类型(仅包含年月日),默认其时间部分为 00:00:00。
  • 若输入的日期时间包含微秒部分,添加分钟后会保留原微秒精度(如 '2023-01-01 00:00:00.123456' 添加 1 分钟后为 '2023-01-01 00:01:00.123456')。
  • 若计算结果超出 DATETIME 类型的有效范围(0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999),抛出异常。
  • 若任一参数为 NULL,返回 NULL。

举例

--- 向 DATE 类型添加分钟(默认时间 00:00:00)
SELECT MINUTES_ADD('2020-02-02', 1) AS result;
+---------------------+
| result              |
+---------------------+
| 2020-02-02 00:01:00 |
+---------------------+

--- 向 DATETIME 添加分钟
SELECT MINUTES_ADD('2023-07-13 22:28:18', 5) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-13 22:33:18 |
+---------------------+

--- 包含微秒的时间(保留精度)
SELECT MINUTES_ADD('2023-07-13 22:28:18.456789', 10) AS result;
+----------------------------+
| result                     |
+----------------------------+
| 2023-07-13 22:38:18.456789 |
+----------------------------+

--- 负数分钟(等价于减法)
SELECT MINUTES_ADD('2023-07-13 22:28:18', -5) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-13 22:23:18 |
+---------------------+

-- TimeStampTz 类型测试, SET time_zone = '+08:00'
SELECT MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1);
+-------------------------------------------------+
| MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1) |
+-------------------------------------------------+
| 2025-10-10 12:23:33.123+08:00                   |
+-------------------------------------------------+

--- 任一参数为 NULL,返回 NULL
SELECT MINUTES_ADD(NULL, 10), MINUTES_ADD('2023-07-13 22:28:18', NULL) AS result;
+-------------------------+--------+
| minutes_add(NULL, 10)   | result |
+-------------------------+--------+
| NULL                    | NULL   |
+-------------------------+--------+

--- 计算结果超出日期时间范围,报错
SELECT MINUTES_ADD('9999-12-31 23:59:59', 2) AS result;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_add of 9999-12-31 23:59:59, 2 out of range

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

资料来源与适用范围

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

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

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