MySQLのDATEDIFF()関数に時刻を含む日付値を指定した場合、どのような結果が返されるのか？

MySQLのDATEDIFF()関数は、日付と時刻の両方を含む値（DATETIME型など）を引数として受け取ることができます。しかし、この関数は計算の際に時刻部分を完全に無視するという重要な特徴を持っています。

DATEDIFF()関数の基本的な動作

そのため、引数に時刻コンポーネントが含まれていても、DATEDIFF()関数は時刻を無視し、2つの日付間の日数差のみを返します。

実行例1：1年差の日付の場合

mysql> Select DATEDIFF('2018-10-22 04:05:36','2017-10-22 03:05:45');
+-------------------------------------------------------+
| DATEDIFF('2018-10-22 04:05:36','2017-10-22 03:05:45') |
+-------------------------------------------------------+
|                                                   365 |
+-------------------------------------------------------+
1 row in set (0.00 sec)

実行例2：同じ日付で時刻のみ異なる場合

mysql> Select DATEDIFF('2017-10-22 04:05:36','2017-10-22 03:05:45');
+-------------------------------------------------------+
| DATEDIFF('2017-10-22 04:05:36','2017-10-22 03:05:45') |
+-------------------------------------------------------+
|                                                     0 |
+-------------------------------------------------------+
1 row in set (0.00 sec)

結果からわかること

上記のクエリ結果を見ると、次のことが確認できます。

• 例1： 日付がちょうど1年（365日）異なるため、時刻がわずかに違っていても「365」が返されます。
• 例2： 日付は同じで時刻だけが異なる場合、時刻の差が約1時間あっても「0」が返されます。

つまり、DATEDIFF()関数は日付同士の比較のみを行い、時・分・秒の情報は計算対象外となります。時刻まで含めた正確な差分を求めたい場合は、TIMESTAMPDIFF()関数など、時刻を考慮できる別の関数を使用することをおすすめします。