TIMESTAMPDIFF
説明
timestampdiff 関数は、2つの日付の差を計算し、それらの間の時間間隔を返すために使用されます。差は指定された時間単位（秒、分、時間、日、月、年など）で返すことができます。
構文
TIMESTAMPDIFF(<unit>, <datetime_expr1>, <datetime_expr2>)
パラメータ
| パラメータ | 説明 |
|---|---|
unit | 時間単位、差を返す単位を指定します。SECOND、MINUTE、HOUR、DAY、MONTH、QUARTER、YEAR をサポートします |
ヒント
QUARTER はバージョン 3.0.8 および 3.1.0 以降でサポートされています。
| datetime_expr1 | 最初のdatetime、有効な対象日付 |
| datetime_expr2 | 2番目のdatetime、有効な対象日付 |
戻り値
戻り値は2つのdate-timeの差で、単位は unit パラメータによって決まります。
入力パラメータが無効な場合、NULL が返されます。
例
SELECT TIMESTAMPDIFF(MONTH,'2003-02-01','2003-05-01');
+--------------------------------------------------------------------+
| timestampdiff(MONTH, '2003-02-01 00:00:00', '2003-05-01 00:00:00') |
+--------------------------------------------------------------------+
| 3 |
+--------------------------------------------------------------------+
SELECT TIMESTAMPDIFF(QUARTER,'2002-05-01','2001-01-01');
+--------------------------------------------------+
| TIMESTAMPDIFF(QUARTER,'2002-05-01','2001-01-01') |
+--------------------------------------------------+
| -5 |
+--------------------------------------------------+
SELECT TIMESTAMPDIFF(YEAR,'2002-05-01','2001-01-01');
+-------------------------------------------------------------------+
| timestampdiff(YEAR, '2002-05-01 00:00:00', '2001-01-01 00:00:00') |
+-------------------------------------------------------------------+
| -1 |
+-------------------------------------------------------------------+
SELECT TIMESTAMPDIFF(MINUTE,'2003-02-01','2003-05-01 12:05:55');
+---------------------------------------------------------------------+
| timestampdiff(MINUTE, '2003-02-01 00:00:00', '2003-05-01 12:05:55') |
+---------------------------------------------------------------------+
| 128885 |
+---------------------------------------------------------------------+
SELECT TIMESTAMPDIFF(MINUTE,'2003-02-01','1196440219');
+-----------------------------------------------------------------------------------+
| timestampdiff(MINUTE, '2003-02-01 00:00:00', CAST('1196440219' AS datetimev2(6))) |
+-----------------------------------------------------------------------------------+
| NULL |
+-----------------------------------------------------------------------------------+