SUBTRACT TIME INTERVAL

Subtract time interval from a date or timestamp, return the result of date or timestamp type.

Syntax

SUBTRACT_YEARS(<exp0>, <expr1>)
SUBTRACT_QUARTERS(<exp0>, <expr1>)
SUBTRACT_MONTHS(<exp0>, <expr1>)
SUBTRACT_DAYS(<exp0>, <expr1>)
SUBTRACT_HOURS(<exp0>, <expr1>)
SUBTRACT_MINUTES(<exp0>, <expr1>)
SUBTRACT_SECONDS(<exp0>, <expr1>)

Return Type

DATE, TIMESTAMP depends on the input.

Examples

SELECT to_date(18875), subtract_years(to_date(18875), 2);

┌────────────────────────────────────────────────────┐
│ to_date(18875) │ subtract_years(to_date(18875), 2) │
├────────────────┼───────────────────────────────────┤
│ 2021-09-05     │ 2019-09-05                        │
└────────────────────────────────────────────────────┘

SELECT to_date(18875), subtract_quarters(to_date(18875), 2);

┌───────────────────────────────────────────────────────┐
│ to_date(18875) │ subtract_quarters(to_date(18875), 2) │
├────────────────┼──────────────────────────────────────┤
│ 2021-09-05     │ 2021-03-05                           │
└───────────────────────────────────────────────────────┘

SELECT to_date(18875), subtract_months(to_date(18875), 2);

┌─────────────────────────────────────────────────────┐
│ to_date(18875) │ subtract_months(to_date(18875), 2) │
├────────────────┼────────────────────────────────────┤
│ 2021-09-05     │ 2021-07-05                         │
└─────────────────────────────────────────────────────┘

SELECT to_date(18875), subtract_days(to_date(18875), 2);

┌───────────────────────────────────────────────────┐
│ to_date(18875) │ subtract_days(to_date(18875), 2) │
├────────────────┼──────────────────────────────────┤
│ 2021-09-05     │ 2021-09-03                       │
└───────────────────────────────────────────────────┘

SELECT to_datetime(1630833797), subtract_hours(to_datetime(1630833797), 2);

┌──────────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ subtract_hours(to_datetime(1630833797), 2) │
├─────────────────────────┼────────────────────────────────────────────┤
│ 2021-09-05 09:23:17     │ 2021-09-05 07:23:17                        │
└──────────────────────────────────────────────────────────────────────┘

SELECT to_datetime(1630833797), subtract_minutes(to_datetime(1630833797), 2);

┌────────────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ subtract_minutes(to_datetime(1630833797), 2) │
├─────────────────────────┼──────────────────────────────────────────────┤
│ 2021-09-05 09:23:17     │ 2021-09-05 09:21:17                          │
└────────────────────────────────────────────────────────────────────────┘

SELECT to_datetime(1630833797), subtract_seconds(to_datetime(1630833797), 2);

┌────────────────────────────────────────────────────────────────────────┐
│ to_datetime(1630833797) │ subtract_seconds(to_datetime(1630833797), 2) │
├─────────────────────────┼──────────────────────────────────────────────┤
│ 2021-09-05 09:23:17     │ 2021-09-05 09:23:15                          │
└────────────────────────────────────────────────────────────────────────┘