MONTHS_DIFF

説明

MONTHS_DIFF 関数は、二つの日時値の間の整数の月数の差を計算し、<startdate> を <enddate> から引いて得られる月数を返します。この関数は DATE 型と DATETIME 型をサポートし、日付部分（年、月、日）のみを使って計算し、時刻部分（時、分、秒）は無視します。

構文

MONTHS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)

パラメータ

パラメータ	説明
<date_or_time_expr1>	終了日。DATE 型と DATETIME 型をサポートします。日時と日付の具体的な形式については、日時の変換および日付の変換を参照してください。
<date_or_time_expr2>	開始日。DATE 型と DATETIME 型をサポートします。

戻り値

<date_or_time_expr2> を <date_or_time_expr1> から引いて得られる月数を BIGINT 型で返します。

基準となる差 =（終了年 - 開始年）× 12 +（終了月 - 開始月）。 終了日の日の部分が開始日の日の部分より小さい場合、最終結果 = 基準となる差 - 1。 それ以外の場合、最終結果 = 基準となる差。

• <date_or_time_expr1> が <date_or_time_expr2> より前の場合は、負の値を返します（計算方法は同じで、符号だけが逆になります）。
• いずれかの引数が NULL の場合は、NULL を返します。
• 実際に丸ひと月の差があるかどうかを考慮します（日、時などを含みます）。

例

--- Year-month difference is 1, and end day < start day (result minus 1)
SELECT MONTHS_DIFF('2020-03-28', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- Year-month difference is 1, and end day = start day
SELECT MONTHS_DIFF('2020-03-29', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- Year-month difference is 1, and end day > start day
SELECT MONTHS_DIFF('2020-03-30', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- End date is earlier than start date (negative value logic is the same)
SELECT MONTHS_DIFF('2020-02-29', '2020-03-28') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

SELECT MONTHS_DIFF('2020-02-29', '2020-03-29') AS result;
+--------+
| result |
+--------+
|     -1 |
+--------+

--- Same month (result is 0)
SELECT MONTHS_DIFF('2023-07-15', '2023-07-30') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--Takes into account whether there is an actual full month difference (including days, hours, etc.)
mysql> SELECT MONTHS_DIFF('2020-03-28', '2020-01-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

mysql> SELECT MONTHS_DIFF('2020-03-28 22:22:22', '2020-02-29 23:12:12') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- Input is NULL (returns NULL)
SELECT MONTHS_DIFF(NULL, '2023-01-01') AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+