date_add 函数

date_add(startDate, numDays)

功能描述

该函数用于计算并返回在给定的日期

startDate

基础上增加

numDays

天后的日期。如果计算结果超出了系统所支持的日期范围，则会返回

null

。

参数说明

• startDate

  startDate
  (date): 起始日期，需要符合日期格式。

• numDays

  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

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

  null

  null
  。
• 当

  numDays

  numDays
  为负数时，表示从

  startDate

  startDate
  往回推

  numDays

  numDays
  天。
• 请留意系统所支持的日期范围，超出范围的计算结果将返回

  null

  null
  。