ADD_YEARS 函数

add_years(startDate, numYears)

功能描述

该函数用于计算并返回在给定的开始日期（startDate）基础上增加（或减少）指定年数（numYears）后的日期。如果计算结果超出了系统支持的日期范围，则会返回 null。

参数说明

• startDate

  startDate
  ：类型为

  date

  date
  ，表示计算开始的日期。

• numYears

  numYears
  ：类型为

  int

  int
  ，表示要增加或减少的年数，可以为正数或负数。

返回结果

返回一个

date

使用示例

1. 计算未来的日期：

SELECT add_years('2020-05-31', 3); +----------------------------+ | add_years('2020-05-31', 3) | +----------------------------+ | 2023-05-31 | +----------------------------+

2. 计算过去的日期：

SELECT add_years('2020-05-31', -5); +-----------------------------+ | add_years('2020-05-31', -5) | +-----------------------------+ | 2015-05-31 | +-----------------------------+

3. 当增加的年数导致结果超出系统日期范围时，返回 null：

SELECT add_years('1900-01-01', 200); +------------------------------+ | add_years('1900-01-01', 200) | +------------------------------+ | 2100-01-01 | +------------------------------+1

注意事项

• 确保输入的

  startDate

  startDate
  参数为有效的日期格式，否则可能导致计算结果不准确。
• 当

  numYears

  numYears
  为负数时，表示从开始日期往过去推算相应的年数。
• 如果计算结果超出系统支持的日期范围，函数将返回 null，请注意处理这种情况。