跳到主要内容

MONTHS_ADD

描述

MONTHS_ADD 函数用于对指定日期添加或减去指定的月份数,并返回计算后的新日期

语法

MONTHS_ADD(<datetime/date>, <nums>)

参数

参数说明
<datetime/date>需要被计算加减月份的日期值
<nums>需要加减的月份数

返回值

返回值与输入的 <datetime/date> 类型一致 特殊情况:

  • <datetime/date> 输入为 0000-00-00 或 0000-00-00 00:00:00 时,返回 NULL
  • <datetime/date> 输入为 NULL 时,返回 NULL
  • 如果输入为 months_add("9999-12-31",1),将返回 NULL

举例

select months_add("2020-01-31 02:02:02", 1),months_add("2020-01-31", 1),months_add("2020-01-31", -1);
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+
| months_add(cast('2020-01-31 02:02:02' as DATETIMEV2(0)), 1) | months_add(cast('2020-01-31' as DATEV2), 1) | months_add(cast('2020-01-31' as DATEV2), -1) |
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+
| 2020-02-29 02:02:02 | 2020-02-29 | 2019-12-31 |
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+