メインコンテンツまでスキップ
バージョン: 3.2

days_diff

Description​

2 つの日付式（expr1 − expr2）の間の日数の差を返します。日単位で正確です。

days_diff と datediff の違い:

FunctionBehaviorExample
days_diff計算は秒単位で正確で、最も近い整数に切り捨てられます。'2020-12-25 23:00:00' と '2020-12-24 23:00:01' の間の days_diff は 0 です。
datediff計算は日単位で正確です。'2020-12-25 23:00:00' と '2020-12-24 23:00:01' の間の datediff は 1 です。

Syntax​

BIGINT days_diff(DATETIME expr1,DATETIME expr2);

Parameters​

  • expr1: 終了時間。DATETIME または DATE 型である必要があります。

  • expr2: 開始時間。DATETIME または DATE 型である必要があります。

Return value​

BIGINT 値を返します。

日付が存在しない場合、例えば 2022-02-29 の場合は NULL が返されます。days_diff() は時間、分、秒の部分を計算に含めます。差が 1 日未満の場合、0 が返されます。

Examples​

select days_diff('2010-11-30 23:00:00', '2010-11-29 23:00:00')
+---------------------------------------------------------+
| days_diff('2010-11-30 23:00:00', '2010-11-29 23:00:00') |
+---------------------------------------------------------+
| 1                                                       |
+---------------------------------------------------------+

select days_diff('2010-11-30 23:00:00', '2010-11-29 23:10:00')
+---------------------------------------------------------+
| days_diff('2010-11-30 23:00:00', '2010-11-29 23:10:00') |
+---------------------------------------------------------+
| 0                                                       |
+---------------------------------------------------------+