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

Apache Doris 中文参考:SECONDS_ADD

· 52CE 我爱测

返回基准时间 添加指定秒数 的值,返回值类型由第一个参数类型决定: - 若第一个参数为 或 ,返回 ;若为 ,返回 。 - 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。

描述

SECONDS_ADD 函数用于在指定的日期时间值上增加或减少指定的秒数,并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS、TIMESTAMPTZ 类型,若输入负数则等效于减去对应秒数。

该函数与 date_add 函数 和 mysql 中的 date_add 函数 使用 SECOND 为单位的行为一致

语法

SECONDS_ADD(<date_or_time_expr>, <seconds>)

参数

参数 说明
<date_or_time_expr> 必填,输入的日期时间值,类型可以是 DATE、DATETIME、TIMESTAMP_NS、TIMESTAMPTZ,具体格式请查看 timestamptz的转换, datetime 的转换, date 的转换
<seconds> 必填,要增加或减少的秒数,支持整数类型(BIGINT)。正数表示增加秒数,负数表示减少秒数。

返回值

返回基准时间<date_or_time_expr>添加指定秒数<second>的值,返回值类型由第一个参数类型决定:

  • 若第一个参数为 DATE 或 DATETIME,返回 DATETIME;若为 TIMESTAMP_NS,返回 TIMESTAMP_NS。
  • 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。

特殊情况:

  • 若 为负数,函数效果等同于从基准时间中减去对应秒数(即 SECONDS_ADD(date, -n) 等价于 SECONDS_SUB(date, n))。
  • 若输入为 DATE 类型(仅包含年月日),默认其时间部分为 00:00:00/
  • 若计算结果超出日期类型的有效范围(DATE 类型:0000-01-01 至 9999-12-31;DATETIME/TIMESTAMPTZ 类型:0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999),返回错误。
  • 若任一参数为 NULL,返回 NULL。

举例

--- 向 DATETIME 类型添加秒数
SELECT SECONDS_ADD('2025-01-23 12:34:56', 30) AS result;
+---------------------+
| result              |
+---------------------+
| 2025-01-23 12:35:26 |
+---------------------+

--- 从 DATETIME 类型减去秒数(使用负数)
SELECT SECONDS_ADD('2025-01-23 12:34:56', -30) AS result;
+---------------------+
| result              |
+---------------------+
| 2025-01-23 12:34:26 |
+---------------------+

--- 跨分钟边界的秒数添加
SELECT SECONDS_ADD('2023-07-13 23:59:50', 15) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-14 00:00:05 |
+---------------------+

--- 输入为 DATE 类型(默认时间 00:00:00)
SELECT SECONDS_ADD('2023-01-01', 3600) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-01-01 01:00:00 |
+---------------------+

--- 包含 scale 的 DATETIME(保留精度)
SELECT SECONDS_ADD('2023-07-13 10:30:25.123456', 2) AS result;
+----------------------------+
| result                     |
+----------------------------+
| 2023-07-13 10:30:27.123456 |
+----------------------------+

-- TimeStampTz 类型示例, SET time_zone = '+08:00'
SELECT SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1);
+-------------------------------------------------+
| SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
+-------------------------------------------------+
| 2025-10-10 12:22:34.123+08:00                   |
+-------------------------------------------------+

--- 输入为 NULL 时返回 NULL
SELECT SECONDS_ADD(NULL, 30), SECONDS_ADD('2025-01-23 12:34:56', NULL) AS result;
+-------------------------+--------+
| seconds_add(NULL, 30)   | result |
+-------------------------+--------+
| NULL                    | NULL   |
+-------------------------+--------+

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

select seconds_add('0000-01-01 00:00:30',-31);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation seconds_add of 0000-01-01 00:00:30, -31 out of range

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

资料来源与适用范围

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

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

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