カテゴリ:

日付と時刻の関数

TIMEDIFF

指定された日付または時刻の部分に基づいて、2つの日付、時刻、またはタイムスタンプ式の差を計算します。

DATEDIFF の代替です。

構文

TIMEDIFF( <date_or_time_part> , <date_or_time_expr1> , <date_or time_expr2> )

引数

  • 日付または時刻部分 は、 サポートされている日付と時刻の部分 にリストされている値のいずれかでなければなりません。

  • 日付または時刻式1日付または時刻式2 は、日付、時刻、タイムスタンプであるか、それらのいずれかを評価できる式でなければなりません。最初の値が2番目の値から減算されます。

使用上の注意

  • その他の使用上の注意については、 DATEDIFF引数 をご参照ください。

これは、2番目の日付が最初の日付より2年遅い2つの日付を減算した結果を示しています。

SELECT TIMEDIFF(YEAR, '2017-01-01', '2019-01-01') AS Years;

出力:

+--------+
| YEARS  |
+========+
|     2  |
+--------+

これは、最も近い値に四捨五入しないことを示しています。差は11か月よりも12か月に近いですが、差を11か月として計算します。

SELECT TIMEDIFF(MONTH, '2017-01-1', '2017-12-31') AS Months;

出力:

+--------+
| MONTHS |
+========+
|    11  |
+--------+

DATEDIFF には追加の例があります。