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 |
+----------------------------------------------------------------------------------------------------------+