跳到主要内容
版本:Latest-3.3

add_months

功能

在给定的日期(DATE、DATETIME)上增加一个整数月,返回结果日期。

months 可以是正数或负数。

返回的日期部分将与日期中指定的部分相同,除非返回的月比给定日期的日部分少,在这种情况下,日将是返回的月的最后一天。

如果给定的日期无效或者为 NULL,则返回 NULL。

语法

ADD_MONTHS(date, months);

参数说明

  • date: 给定的日期,可以是DATE、DATETIME 类型。
  • months: 要增加的整数月。

返回值说明

返回值的数据类型为 DATETIME。

示例

> select add_months('2022-01-01', 2);
+-----------------------------+
| add_months('2022-01-01', 2) |
+-----------------------------+
| 2022-03-01 00:00:00 |
+-----------------------------+

> select add_months('2022-01-01', -5);
+------------------------------+
| add_months('2022-01-01', -5) |
+------------------------------+
| 2021-08-01 00:00:00 |
+------------------------------+

> select add_months('2022-01-31', 2);
+-----------------------------+
| add_months('2022-01-31', 2) |
+-----------------------------+
| 2022-03-31 00:00:00 |
+-----------------------------+

> select add_months('2022-01-31 17:01:02', 2);
+--------------------------------------+
| add_months('2022-01-31 17:01:02', 2) |
+--------------------------------------+
| 2022-03-31 17:01:02 |
+--------------------------------------+

> select add_months('2022-01-31 17:01:02', -2);
+---------------------------------------+
| add_months('2022-01-31 17:01:02', -2) |
+---------------------------------------+
| 2021-11-30 17:01:02 |
+---------------------------------------+