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

TIMEDIFF

説明​

TIMEDIFF関数は、2つのdatetime値の差を計算します。この関数は2つの引数を受け取り、差をTIME型として返します。

構文​

TIMEDIFF(<end_datetime>, <start_datetime>)

パラメータ​

Parameterデスクリプション
<end_datetime>終了日時値。
<start_datetime>開始日時値。

Return Value​

2つの入力間の差を表すTIME型の値を返します：

  • <end_datetime>が<start_datetime>より後の場合、正の時間差を返します。
  • <end_datetime>が<start_datetime>より前の場合、負の時間差を返します。
  • <end_datetime>と<start_datetime>が等しい場合、00:00:00を返します。
  • <end_datetime>または<start_datetime>がNULLの場合、関数はNULLを返します。
  • <end_datetime>または<start_datetime>が無効な日時値（例：0000-00-00 00:00:00）の場合、関数はNULLを返します。

Example​

SELECT TIMEDIFF('2024-07-20 16:59:30','2024-07-11 16:35:21');
+------------------------------------------------------------------------------------------------------+
| timediff(cast('2024-07-20 16:59:30' as DATETIMEV2(0)), cast('2024-07-11 16:35:21' as DATETIMEV2(0))) |
+------------------------------------------------------------------------------------------------------+
| 216:24:09                                                                                            |
+------------------------------------------------------------------------------------------------------+