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

Apache Doris 中文参考:SECONDS_DIFF

· 52CE 我爱测

SECONDS_DIFF 函数用于计算两个日期时间值之间的差值,并以秒为单位返回结果。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS 类型,若输入为 DATE 类型,默认其时间部分为 00:00:00。

描述

SECONDS_DIFF 函数用于计算两个日期时间值之间的差值,并以秒为单位返回结果。该函数支持处理 DATE、DATETIME、TIMESTAMP_NS 类型,若输入为 DATE 类型,默认其时间部分为 00:00:00。

语法

SECONDS_DIFF(<date_or_time_expr1>, <date_or_time_expr2>)

参数

参数 说明
<date_or_time_expr1> 必填,结束的日期时间值,类型可以是 DATE、DATETIME、TIMESTAMP_NS,具体 datetime/date 请查看 datetime 的转换, date 的转换
<date_or_time_expr2> 必填,起始的日期时间值,类型可以是 DATE、DATETIME、TIMESTAMP_NS。。

返回值

返回类型为 BIGINT,表示两个日期时间之间的秒数差:

  • 若 <date_or_time_expr1> 晚于 <date_or_time_expr2>,返回正数;
  • 若 <date_or_time_expr1> 早于 <date_or_time_expr2>,返回负数;
  • 若两个时间相等,返回 0;
  • 若任一参数为 NULL,返回 NULL;
  • 包含 scale 的时间,会把小数部分差距算入

举例

--- 同一小时内的秒差
SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56') AS result;
+--------+
| result |
+--------+
|     60 |
+--------+

--- 结束时间早于起始时间(返回负数)
SELECT SECONDS_DIFF('2023-01-01 00:00:00', '2023-01-01 00:01:00') AS result;
+--------+
| result |
+--------+
|    -60 |
+--------+

--- 输入为 DATE 类型(默认时间 00:00:00)
SELECT SECONDS_DIFF('2023-01-02', '2023-01-01') AS result;  -- 相差1天(86400秒)
+--------+
| result |
+--------+
|  86400 |
+--------+

--- 任一参数均可使用 TIMESTAMP_NS
SELECT SECONDS_DIFF(CAST('2024-01-01 00:00:02.000000000' AS TIMESTAMP_NS),
                    CAST('2024-01-01 00:00:00' AS DATETIME)) AS result;
+--------+
| result |
+--------+
|      2 |
+--------+

--- 包含 scale 的时间,会把小数部分差距算入
mysql> SELECT SECONDS_DIFF('2023-07-13 12:00:00', '2023-07-13 11:59:59.6') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- 任一参数为 NULL(返回 NULL)
SELECT SECONDS_DIFF(NULL, '2023-07-13 10:30:25'), SECONDS_DIFF('2023-07-13 10:30:25', NULL) AS result;
+-------------------------------------------+--------+
| seconds_diff(NULL, '2023-07-13 10:30:25') | result |
+-------------------------------------------+--------+
| NULL                                      | NULL   |
+-------------------------------------------+--------+

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

资料来源与适用范围

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

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

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