メインコンテンツまでスキップ
バージョン: 4.x

SECONDS_DIFF

説明​

この関数は2つのdatetime値の時間差を計算し、その差を秒単位で返します。

構文​

SECONDS_DIFF(<end_datetime>, <start_datetime>)

パラメータ​

Parameterデスクリプション
<end_datetime>必須。終了日時の値。DATETIMEおよびDATE型をサポートします。
<start_datetime>必須。開始日時の値。DATETIMEおよびDATE型をサポートします。

Return Value​

  • 2つの日時値の秒単位の差を表す整数を返します：
    • <end_datetime>が<start_datetime>より後の場合、正の値を返します。
    • <end_datetime>が<start_datetime>より前の場合、負の値を返します。
    • <end_datetime>と<start_datetime>が等しい場合、0を返します。
  • いずれかのパラメータがNULLの場合、関数はNULLを返します。
  • 入力された日時値が無効な場合（例：0000-00-00T00:00:00）、関数はNULLを返します。

Example​

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