ADD_YEARS 函数

add_years(startDate, numYears)

功能描述

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

参数说明

• startDate：类型为 date，表示计算开始的日期。
• numYears：类型为 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 参数为有效的日期格式，否则可能导致计算结果不准确。
• 当 numYears 为负数时，表示从开始日期往过去推算相应的年数。
• 如果计算结果超出系统支持的日期范围，函数将返回 null，请注意处理这种情况。