SECONDS_DIFF
更新时间：2025-10-17
描述
函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
语法
SQL
1SECONDS_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。
举例
SQL
1SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
Text
1+----------------------------------------------------------------------------------------------------------+
2| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
3+----------------------------------------------------------------------------------------------------------+
4| 60 |