date_add 函数

date_add(startDate, numDays)

功能描述

该函数用于计算并返回在给定的日期 startDate 基础上增加 numDays 天后的日期。如果计算结果超出了系统所支持的日期范围，则会返回 null。

参数说明

• startDate (date): 起始日期，需要符合日期格式。
• numDays (int): 需要增加的天数，可以为正整数（增加天数）或负整数（减少天数）。

返回结果

返回一个新的日期，该日期是 startDate 加上 numDays 天之后的结果，如果结果超出日期范围，则返回 null。

使用示例

1. 增加天数：

SELECT date_add('2020-05-31', 10); -- 返回 2020-06-10

2. 减少天数：

SELECT date_add('2020-06-10', -3); -- 返回 2020-06-07

3. 跨年计算：

SELECT date_add('2020-12-31', 1); -- 返回 2021-01-01

4. 超出日期范围：

SELECT date_add('9999-12-31', 1); -- 返回 null

注意事项

• 确保 startDate 参数为有效的日期格式，否则可能导致函数返回 null。
• 当 numDays 为负数时，表示从 startDate 往回推 numDays 天。
• 请留意系统所支持的日期范围，超出范围的计算结果将返回 null。