SECONDS_DIFF
説明
この関数は2つのdatetime値の時間差を計算し、その差を秒単位で返します。
構文
SECONDS_DIFF(<end_datetime>, <start_datetime>)
パラメータ
| パラメータ | 説明 |
|---|---|
<end_datetime> | 必須。終了datetime値。DATETIMEとDATE型をサポート。 |
<start_datetime> | 必須。開始datetime値。DATETIMEとDATE型をサポート。 |
戻り値
- 2つのdatetime値間の秒単位の差を表す整数を返します：
<end_datetime>が<start_datetime>より後の場合、正の値を返します。<end_datetime>が<start_datetime>より前の場合、負の値を返します。<end_datetime>と<start_datetime>が等しい場合、0を返します。
- いずれかのパラメータがNULLの場合、関数はNULLを返します。
- 入力されたdatetime値が無効な場合（例：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 |
+----------------------------------------------------------------------------------------------------------+
