ADD TIME INTERVAL
Add a time interval to a date or timestamp, return the result of date or timestamp type.
Syntax
ADD_YEARS(<exp0>, <expr1>)
ADD_QUARTERs(<exp0>, <expr1>)
ADD_MONTHS(<exp0>, <expr1>)
ADD_DAYS(<exp0>, <expr1>)
ADD_HOURS(<exp0>, <expr1>)
ADD_MINUTES(<exp0>, <expr1>)
ADD_SECONDS(<exp0>, <expr1>)
Return Type
DATE
, TIMESTAMP
, depends on the input.
Examples
SELECT to_date(18875), add_years(to_date(18875), 2);
┌───────────────────────────────────────────────┐
│ to_date(18875) │ add_years(to_date(18875), 2) │
├────────────────┼──────────────────────────────┤
│ 2021-09-05 │ 2023-09-05 │
└───────────────────────────────────────────────┘
SELECT to_date(18875), add_quarters(to_date(18875), 2);
┌──────────────────────────────────────────────────┐
│ to_date(18875) │ add_quarters(to_date(18875), 2) │
├────────────────┼─────────────────────────────────┤
│ 2021-09-05 │ 2022-03-05 │
└──────────────────────────────────────────────────┘
SELECT to_date(18875), add_months(to_date(18875), 2);
┌────────────────────────────────────────────────┐
│ to_date(18875) │ add_months(to_date(18875), 2) │
├────────────────┼───────────────────────────────┤
│ 2021-09-05 │ 2021-11-05 │
└────────────────────────────────────────────────┘
SELECT to_date(18875), add_days(to_date(18875), 2);
┌──────────────────────────────────────────────┐
│ to_date(18875) │ add_days(to_date(18875), 2) │
├────────────────┼─────────────────────────────┤
│ 2021-09-05 │ 2021-09-07 │
└──────────────────────────────────────────────┘
SELECT to_datetime(1630833797), add_hours(to_datetime(1630833797), 2);
┌─────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ add_hours(to_datetime(1630833797), 2) │
├─────────────────────────┼───────────────────────────────────────┤
│ 2021-09-05 09:23:17 │ 2021-09-05 11:23:17 │
└─────────────────────────────────────────────────────────────────┘
SELECT to_datetime(1630833797), add_minutes(to_datetime(1630833797), 2);
┌───────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ add_minutes(to_datetime(1630833797), 2) │
├─────────────────────────┼─────────────────────────────────────────┤
│ 2021-09-05 09:23:17 │ 2021-09-05 09:25:17 │
└───────────────────────────────────────────────────────────────────┘
SELECT to_datetime(1630833797), add_seconds(to_datetime(1630833797), 2);
┌───────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ add_seconds(to_datetime(1630833797), 2) │
├─────────────────────────┼─────────────────────────────────────────┤
│ 2021-09-05 09:23:17 │ 2021-09-05 09:23:19 │
└───────────────────────────────────────────────────────────────────┘