DATE_DIFF

Returns the difference between two expressions of time as another expression of time.

Syntax

DATE_DIFF(date_expression DATE, days INTEGER) → DATE

• date_expression: The date, in the format ‘YYY-MM-DD’, to subtract days from. The value can be either a database column in DATE format, or literal value explicitly converted to DATE.

• days: A 32-bit integer of the number of days to be subtracted from the specified date.

Examples

Subtracts five days from the specified date.

SELECT DATE_DIFF(DATE '2022-01-01', 5)
-- 2021-12-27

Subtracts negative five days from the specified date.

SELECT DATE_DIFF(DATE '2022-01-01', -5)
-- 2022-01-06

DATE_DIFF(date_expression DATE, date_expression DATE) → INTERVAL DAY

• date_expression: The date, in the format ‘YYY-MM-DD’, to subtract the second date from. The value can be either a database column in DATE format, or literal value explicitly converted to DATE.

• date_expression: The date, in the format ‘YYY-MM-DD’, to subtract from the first date. The value can be either a database column in DATE format, or literal value explicitly converted to DATE.

Examples

Subtracts the second date from the first date.

SELECT DATE_DIFF(DATE '2022-04-01', DATE '2022-01-01')
-- +090 00:00:00.000

Subtracts the second date from the first date.

SELECT DATE_DIFF(DATE '2022-01-01', DATE '2022-04-01')
-- -090 00:00:00.000

DATE_DIFF(timestamp_expression TIMESTAMP, timestamp_expression TIMESTAMP) → INTERVAL DAY

• timestamp_expression: The timestamp, in the format ‘YYYY-MM-DD HH:MM:SS’, to subtract the second timestamp from. The value can be either a database column in TIMESTAMP format, or literal value explicitly converted to TIMESTAMP.

• timestamp_expression: The timestamp, in the format ‘YYYY-MM-DD HH:MM:SS’, to subtract from the first timestamp. The value can be either a database column in TIMESTAMP format, or literal value explicitly converted to TIMESTAMP.

Examples

Subtracts the second timestamp from the first timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-04-01 12:35:23', TIMESTAMP '2022-01-01 01:00:00')
-- +090 11:35:23.000

Subtracts the second timestamp from the first timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-01-01 01:00:00', TIMESTAMP '2022-04-01 12:35:23')
-- -090 11:35:23.000

DATE_DIFF(time_expression TIME, time_interval INTERVAL) → TIME

• time_expression: The time, in the format ‘HH:MM:SS’, from which to subtract a number of seconds, minutes, or hours. The value can be either a database column in TIME format, or literal value explicitly converted to TIME.

• time_interval: A CAST of a number to one of these intervals: SECOND, MINUTE, HOUR.

Examples

Subtracts 30 seconds from the specified time.

SELECT DATE_DIFF(TIME '12:00:00', CAST(30 AS INTERVAL SECOND))
-- 11:59:30

Subtracts 30 minutes from the specified time.

SELECT DATE_DIFF(TIME '12:00:00', CAST(30 AS INTERVAL MINUTE))
-- 11:30:00

DATE_DIFF(date_expression DATE, time_interval INTERVAL) → TIMESTAMP

• date_expression: The date, in the format ‘YYYY-MM-DD’, from which to subtract a number of days, months, or years. The value can be either a database column in DATE format, or literal value explicitly converted to DATE.

• time_interval: A CAST of a number to one of these intervals: DAY, MONTH, YEAR.

Examples

Subtracts 30 days from the specified date.

SELECT DATE_DIFF(DATE '2022-01-01', CAST(30 AS INTERVAL DAY))
-- 2021-12-02 00:00:00

Subtracts 30 months from the specified date.

SELECT DATE_DIFF(DATE '2022-01-01', CAST(30 AS INTERVAL MONTH))
-- 2019-07-01 00:00:00

DATE_DIFF(timestamp_expression TIMESTAMP, days INTEGER) → TIMESTAMP

• timestamp_expression: The timestamp, in the format ‘YYYY-MM-DD HH:MM:SS’, to subtract days from. The value can be either a database column in TIMESTAMP format, or literal value explicitly converted to TIMESTAMP.

• days: A 32-bit integer of the number of days to be subtracted from the specified timestamp.

Examples

Subtracts five days from the specified timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-01-01 12:35:23', 5)
-- 2021-12-27 12:35:23

Subtracts negative five days from the specified timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-01-01 12:35:23', -5)
-- 2022-01-06 12:35:23

DATE_DIFF(timestamp_expression TIMESTAMP, time_interval INTERVAL) → TIMESTAMP

• timestamp_expression: The timestamp, in the format ‘YYYY-MM-DD HH:MM:SS’, from which to subtract a number of seconds, minutes, hours, days, months, or years. The value can be either a database column in TIMESTAMP format, or literal value explicitly converted to TIMESTAMP.

• time_interval: A CAST of a number to one of these intervals: SECOND, MINUTE, HOUR, DAY, MONTH, YEAR.

Examples

Subtracts 30 seconds from the specified timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-01-01 01:00:00.000', CAST(30 AS INTERVAL SECOND))
-- 2022-01-01 00:59:30

Subtracts 30 minutes from the specified timestamp.

SELECT DATE_DIFF(TIMESTAMP '2022-01-01 01:00:00.000', CAST(30 AS INTERVAL MINUTE))
-- 2022-01-01 00:30:00