MONTHS_DIFF

描述

MONTHS_DIFF 函数用于计算两个日期时间值之间的整数月份差值，返回结果为 <enddate> 减去 <startdate> 后的月份数。该函数支持处理 DATE、DATETIME 类型，仅基于日期部分（年、月、日）计算，忽略时间部分（时、分、秒）。

语法

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

参数

参数	说明
<date_or_time_expr1>	结束日期，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 datetime 的转换 和 date 的转换。
<date_or_time_expr2>	开始日期，支持输入 date/datetime 类型

返回值

返回 <date_or_time_expr1> 减去 <date_or_time_expr2> 所得月份数，类型为 BIGINT.

基础差值 =（结束年份 - 开始年份）× 12 +（结束月份 - 开始月份）； 若结束日期的「日部分」< 开始日期的「日部分」，则最终结果 = 基础差值 - 1； 其他情况，最终结果 = 基础差值。

• 若 <date_or_time_expr1> 早于 <date_or_time_expr2>，返回负值（计算逻辑同上，仅符号相反）；
• 若任一参数为 NULL，返回 NULL；
• 会考虑实际是否相差 一个月(包括天，时 等部分)

举例

--- 年月差为1，且结束日 < 开始日（结果减1）
SELECT MONTHS_DIFF('2020-03-28', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--- 年月差为1，且结束日 = 开始日
SELECT MONTHS_DIFF('2020-03-29', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- 年月差为1，且结束日 > 开始日
SELECT MONTHS_DIFF('2020-03-30', '2020-02-29') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

--- 结束日期早于开始日期（负值逻辑同理）
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 |
+--------+

--- 同一月份（结果为0）
SELECT MONTHS_DIFF('2023-07-15', '2023-07-30') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

--会考虑月以下的单位
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 |
+--------+

--- 输入为NULL（返回NULL）
SELECT MONTHS_DIFF(NULL, '2023-01-01') AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+