メインコンテンツまでスキップ

TIMEDIFF

説明

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

構文

TIMEDIFF(<end_datetime>, <start_datetime>)

パラメータ

パラメータ説明
<end_datetime>終了datetime値。
<start_datetime>開始datetime値。

戻り値

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>が無効なdatetime値(例:0000-00-00 00:00:00)の場合、関数はNULLを返します。

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