跳到主要内容

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