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 |
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+