TIMESTAMPADD
更新时间：2025-10-17
描述
timestampadd 函数用于将指定的时间单位（如年、月、日、小时、分钟、秒等）添加到一个日期上。这个函数通常用于日期和时间的计算。
语法
TIMESTAMPADD(<unit>, <interval>, <datetime_expr>)
参数
| 参数 | 说明 |
|---|---|
unit |
时间单位，指定要添加的时间单位，常见的值有 SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR |
interval |
要添加的时间间隔，通常是一个整数，可以是正数或负数，表示添加或减去的时间长度 |
datetime_expr |
合法的目标日期，为 DATETIME 类型 |
返回值
返回新的日期时间，表示在指定时间点上添加或减去指定时间间隔后的结果。
如果输入的目标日期不合法，则返回 NULL。
举例
SQL
1SELECT TIMESTAMPADD(MINUTE,1,'2019-01-02');
Text
1+------------------------------------------------+
2| timestampadd(MINUTE, 1, '2019-01-02 00:00:00') |
3+------------------------------------------------+
4| 2019-01-02 00:01:00 |
5+------------------------------------------------+
SQL
1SELECT TIMESTAMPADD(WEEK,1,'2019-01-02');
Text
1+----------------------------------------------+
2| timestampadd(WEEK, 1, '2019-01-02 00:00:00') |
3+----------------------------------------------+
4| 2019-01-09 00:00:00 |
5+----------------------------------------------+
SQL
1SELECT TIMESTAMPADD(WEEK,1,'1196440219');
SQL
1+------------------------------------------------------------+
2| timestampadd(WEEK, 1, CAST('1196440219' AS datetimev2(6))) |
3+------------------------------------------------------------+
4| NULL |
5+------------------------------------------------------------+