ADD_MONTHS 函数

ADD_MONTHS(startDate DATE, numMonths INT)

功能描述

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

参数说明

• startDate: 日期类型，表示要进行月份增加计算的起始日期。
• 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 参数为有效的日期格式，否则会导致函数返回 NULL。
• 当 numMonths 为较大或较小的整数时，请注意结果日期是否在系统支持的日期范围内。