SECONDS_DIFF

描述

函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。

语法

SECONDS_DIFF(<end_datetime>, <start_datetime>)

参数

参数	说明
`<end_datetime>`	必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。
`<start_datetime>`	必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。

返回值

返回一个整数，表示两个日期时间值之间的秒差：
- 如果 <end_datetime> 晚于 <start_datetime>，返回正数。
- 如果 <end_datetime> 早于 <start_datetime>，返回负数。
- 如果 <end_datetime> 和 <start_datetime> 相等，返回 0。
如果任一参数为 NULL，函数返回 NULL。
如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。

举例

SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');

+----------------------------------------------------------------------------------------------------------+
| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
+----------------------------------------------------------------------------------------------------------+
|                                                                                                       60 |

SECONDS_ADD SECONDS_SUB