本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
DATEADD 函数
按指定的间隔递增 a DATE TIME TIMETZ、、或TIMESTAMP值。
语法
DATEADD( datepart, interval, {date|time|timetz|timestamp} )
参数
- datepart
-
函数操作的日期部分（例如年、月、日或小时）。有关更多信息，请参阅 日期或时间戳函数的日期部分。
- interval
-
指定要添加到目标表达式的时间间隔（例如天数）的整数。负整数减去时间间隔。
- date|time|timetz|timestamp
-
隐式转换为DATETIMETIMETZ、、或的DATE、TIMETIMETZ、TIMESTAMP列或TIMESTAMP表达式。DATE、TIMETIMETZ、或TIMESTAMP表达式必须包含指定的日期部分。
返回类型
TIMESTAMP或TIME或TIMETZ取决于输入数据类型。
带有DATE列的示例
以下示例为DATE表中存在的 11 月的每个日期加上 30 天。
select dateadd(day,30,caldate) as novplus30 from date where month='NOV' order by dateid; novplus30 --------------------- 2008-12-01 00:00:00 2008-12-02 00:00:00 2008-12-03 00:00:00 ... (30 rows)
以下示例将 18 个月添加到文本日期值。
select dateadd(month,18,'2008-02-28'); date_add --------------------- 2009-08-28 00:00:00 (1 row)
DATEADD函数的默认列名是 DATE _ ADD。日期值的默认时间戳为 00:00:00。
以下示例向未指定时间戳的日期值添加 30 分钟。
select dateadd(m,30,'2008-02-28'); date_add --------------------- 2008-02-28 00:30:00 (1 row)
您可以用全名或缩写来命名日期部分。在此情况下，m 代表几分钟，而不是几个月。
带有TIME列的示例
以下示例表 TIME _ TEST 有一列 TIME _VAL（类型TIME），其中插入了三个值。
select time_val from time_test; time_val --------------------- 20:00:00 00:00:00.5550 00:58:00
以下示例将 _ TEST 表VAL中的每个 TIME _ 加上 TIME 5 分钟。
select dateadd(minute,5,time_val) as minplus5 from time_test; minplus5 --------------- 20:05:00 00:05:00.5550 01:03:00
以下示例为文本时间值添加 8 小时。
select dateadd(hour, 8, time '13:24:55'); date_add --------------- 21:24:55
以下示例显示时间何时超过 24:00:00 或低于 00:00:00。
select dateadd(hour, 12, time '13:24:55'); date_add --------------- 01:24:55
带有TIMETZ列的示例
这些示例中的输出值UTC是默认时区。
以下示例表 TIMETZ _ TEST 有一列 TIMETZ _VAL（类型TIMETZ），其中插入了三个值。
select timetz_val from timetz_test; timetz_val ------------------ 04:00:00+00 00:00:00.5550+00 05:58:00+00
以下示例向每个 TIMETZ _ VAL in TIMETZ _ TEST 表添加 5 分钟。
select dateadd(minute,5,timetz_val) as minplus5_tz from timetz_test; minplus5_tz --------------- 04:05:00+00 00:05:00.5550+00 06:03:00+00
以下示例将 2 小时添加到一个文本 timetz 值。
select dateadd(hour, 2, timetz '13:24:55 PST'); date_add --------------- 23:24:55+00
带有TIMESTAMP列的示例
这些示例中的输出值UTC是默认时区。
以下示例表 TIMESTAMP _ TEST 有一列 TIMESTAMP _VAL（类型TIMESTAMP），其中插入了三个值。
SELECT timestamp_val FROM timestamp_test; timestamp_val ------------------ 1988-05-15 10:23:31 2021-03-18 17:20:41 2023-06-02 18:11:12
以下示例仅将 2000 年之前的 TIMESTAMP _ VAL 值与 TIMESTAMP _ TEST 中的值相加 20 年。
SELECT dateadd(year,20,timestamp_val) FROM timestamp_test WHERE timestamp_val < to_timestamp('2000-01-01 00:00:00', 'YYYY-MM-DD HH:MI:SS'); date_add --------------- 2008-05-15 10:23:31
以下示例向不带秒指示器的文本时间戳值增加 5 秒。
SELECT dateadd(second, 5, timestamp '2001-06-06'); date_add --------------- 2001-06-06 00:00:05
使用说明
DATEADD(month,...) 和 ADD _ MONTHS 函数对月末日期的处理方式不同：
-
ADD_MONTHS：如果您要添加的日期是该月的最后一天，则无论该月的长度如何，结果始终是结果月份的最后一天。例如，4 月 30 日 + 1 个月是 5 月 31 日。
select add_months('2008-04-30',1); add_months --------------------- 2008-05-31 00:00:00 (1 row) -
DATEADD：如果您添加的日期中的天数少于结果月份中的天数，则结果为结果月份的相应日期，而不是该月的最后一天。例如，4 月 30 日 + 1 个月是 5 月 30 日。
select dateadd(month,1,'2008-04-30'); date_add --------------------- 2008-05-30 00:00:00 (1 row)
使用 dateadd（月、12、...）或 dateadd（年、1、...）时，该DATEADD函数对闰年日期 02-29 的处理方式有所不同。
select dateadd(month,12,'2016-02-29'); date_add --------------------- 2017-02-28 00:00:00 select dateadd(year, 1, '2016-02-29'); date_add --------------------- 2017-03-01 00:00:00
