TIMESTAMPDIFF 関数は、2 つの日付/時刻の差を計算するために使用される MySQL 日付/時刻関数です。その構文は次のとおりです。
TIMESTAMPDIFF(unit, datetime1, datetime2)
このうち単位パラメータは、計算結果の単位を示す文字列です。次のいずれかの値を指定できます。
- 年 - 年
- QUARTER - 四半期
- 月 - 月
- 週 - 週
- 日 - 日
- HOUR - 時間
- 分 - 分
- SECOND - 秒
- MICROSECOND - マイクロ秒
datetime1 および datetime2 パラメーターは日付/時刻式であり、日付、時刻、日時型、またはこれらの型のリテラル値または変数にすることができます。
TIMESTAMPDIFF 関数は、datetime2 から datetime1 を引いた差を、unit で指定された単位で返します。たとえば、単位が MONTH の場合、関数は datetime2 と datetime1 の差を月単位で返します。