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                     │
└───────────────────────────────────────────────────────────────────┘