ADD_MONTHS 函数

ADD_MONTHS(startDate DATE, numMonths INT)

功能描述

ADD_MONTHS

函数用于在给定的日期

startDate

上增加指定数量的月份

numMonths

。执行结果将返回一个新的日期。如果增加月份后得到的日期超出了目标月份的天数范围，函数会自动将日期调整为该月份的最后一天。若计算结果超出了系统所支持的日期范围，则会返回

NULL

。

参数说明

• startDate

  startDate
  : 日期类型，表示要进行月份增加计算的起始日期。

• numMonths

  numMonths
  : 整数类型，表示要增加的月份数量。可以为正数（表示未来日期），也可以为负数（表示过去日期）。

返回结果

返回一个日期类型，代表经过月份增加后的日期。

使用示例

1. 增加月份示例：

SELECT ADD_MONTHS('2020-05-31', 3); -- 结果为：2020-08-31

2. 减少月份示例：

SELECT ADD_MONTHS('2020-05-31', -3); -- 结果为：2020-02-29

3. 超出月份天数范围示例：

SELECT ADD_MONTHS('2020-04-30', 1); -- 结果为：2020-05-30

4. 超出系统日期范围示例：

SELECT ADD_MONTHS('9999-12-31', 1); -- 结果为：NULL

注意事项

• 确保

  startDate

  startDate
  参数为有效的日期格式，否则会导致函数返回

  NULL

  NULL
  。
• 当

  numMonths

  numMonths
  为较大或较小的整数时，请注意结果日期是否在系统支持的日期范围内。