ADD_DAYS 函数

功能描述

ADD_DAYS 函数用于在给定的日期 startDate 上增加 numDays 天数，返回一个新的日期。如果计算结果超出了系统所支持的日期范围，则返回 null。

函数语法

add_days(startDate, numDays)

参数说明

• startDate: 日期类型，表示开始日期。
• numDays: 整数类型，表示要增加的天数。

返回结果

返回一个新的日期，日期类型。

使用示例

1. 增加天数示例：

   SELECT add_days('2020-05-31', 10);
   +----------------------------+
   | add_days('2020-05-31', 10) |
   +----------------------------+
   | 2020-06-10                 |
   +----------------------------+
   

2. 减少天数示例：

   SELECT add_days('2020-05-31', -3);
   +----------------------------+
   | add_days('2020-05-31', -3) |
   +----------------------------+
   | 2020-05-28                 |
   +----------------------------+
   

3. 跨年日期计算示例：

   SELECT add_days('2020-12-31', 365);
   +-----------------------------+
   | add_days('2020-12-31', 365) |
   +-----------------------------+
   | 2021-12-31                  |
   +-----------------------------+
   

4. 超出日期范围示例：

   SELECT add_days('0001-01-01', 100000);
   +--------------------------------+
   | add_days('0001-01-01', 100000) |
   +--------------------------------+
   | 0274-10-17                     |
   +--------------------------------+
   

注意事项

• 确保 startDate 参数为有效的日期格式，否则会导致函数返回 null。
• 当增加的天数导致结果超出系统支持的日期范围时，函数会返回 null。