MySQLで指定した2つの日付間の完全な24時間の日数を計算する方法

DATEDIFF()とTIMESTAMPDIFF()の違い

MySQLのDATEDIFF()関数は、値のうち日付部分のみを計算の対象とします。そのため、時刻まで考慮した「完全な24時間」単位の日数を求めたい場合には、TIMESTAMPDIFF()関数を使用する必要があります。

TIMESTAMPDIFF()関数は、第1引数に時間の単位（DAY、HOUR、MINUTEなど）、第2引数に開始日時、第3引数に終了日時を指定します。戻り値として、指定した単位で測定された2つの日時の差が整数で返されます。

TIMESTAMPDIFF()を使った計算例

例えば、「2017-05-27 11:59:00」と「2017-05-23 12:00:00」の間にある完全な24時間の日数を求めたい場合は、以下のようなMySQLクエリを実行します。

mysql> Select TIMESTAMPDIFF(DAY, '2017-05-23 12:00:00' , '2017-05-27 11:59:00');
+---------------------------------------------------------------------------+
| TIMESTAMPDIFF(DAY, '2017-05-23 12:00:00' , '2017-05-27 11:59:00')         |
+---------------------------------------------------------------------------+
| 3                                                                         |
+---------------------------------------------------------------------------+
1 row in set (0.00 sec)

結果の解説

上記の例では、2つの日付の暦上の差は4日ですが、終了時刻が11時59分であるため、4日目の24時間が満たされていません。TIMESTAMPDIFF(DAY, ...)は完全に24時間が経過した日数のみをカウントするため、結果として「3」が返されます。

このように、時刻を含む正確な期間計算を行いたい場合は、DATEDIFF()ではなくTIMESTAMPDIFF()を使うことで、意図した通りの結果を得ることができます。