Функции даты и времени

Введение в Redshift

Jason Myers

Principal Architect

Получение текущих даты и времени

SYSDATE — дата и время на момент начала транзакции

-- Get current date and time
SELECT SYSDATE;

timestamp
============================
2024-01-27 20:05:55.976353

GETDATE() — дата и время на момент начала оператора, требует скобок

-- Get current date and time
SELECT GETDATE();

timestamp
============================
2024-01-27 20:06:55.976353

Особенности функций даты и времени

Осторожно: функции только для узла-лидера!

DATEDIFF вместо AGE
GETDATE/SYSDATE вместо функций узла-лидера:
- CURRENT_TIME
- CURRENT_TIMESTAMP
- ISFINITE
- LOCALTIME
- LOCALTIMESTAMP
- NOW

Усечение даты и времени

TRUNC возвращает дату из метки времени

-- Get current date based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT TRUNC(SYSDATE);

2024-01-27

DATE_TRUNC('datepart', timestamp) — усекает до указанной части, например часа или дня

-- Truncate to hour based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT DATE_TRUNC('minute', SYSDATE);

2024-01-27 20:05:55

¹ https://docs.aws.amazon.com/redshift/latest/dg/r_Dateparts_for_datetime_functions.html

Извлечение частей дат и меток времени

DATE_PART(datepart, date or timestamp)
- извлекает указанную часть из даты или метки времени

-- Get current month based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT DATE_PART(month, SYSDATE);

Возвращает не только month, day, year
- Примеры: dayofweek, quarter, timezone

-- Get current day of week based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT DATE_PART(dayofweek, SYSDATE);

Сравнение дат и времени

DATE_CMP(date_1, date_2) — относительное сравнение
- Возвращает -1, если date_1 раньше
- Возвращает 0, если даты равны
- Возвращает 1, если date_1 позже
Функции для конкретных типов
- DATE_CMP_TIMESTAMP
- DATE_CMP_TIMESTAMPTZ
- TIMESTAMP_CMP
- TIMESTAMP_CMP_TIMESTAMPTZ
- TIMESTAMPTZ_CMP

-- Compare 5 dates from a table based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
  SELECT date_col, 
         TRUNC(SYSDATE) AS current_date,
         DATE_CMP(date_col, SYSDATE)
    FROM combined_history_projections
ORDER BY date_col
   LIMIT 3;

 date_col  |  current_date | date_cmp
===========|===============|==========
2024-01-26 | 2024-01-27    |       -1
2024-01-27 | 2024-01-27    |        0
2024-01-28 | 2024-01-27    |        1

Вычисление разности дат

DATEDIFF(datepart, value_1, value_2)
Поддерживает date, time, timetz или timestamp в любой позиции
- Необходимо указать datepart
Возвращает
- отрицательное значение, если value_2 раньше
- 0, если даты равны
- положительное значение, если value_2 позже

Использование DATEDIFF

-- Days till end of first quarter based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT DATEDIFF(day,TRUNC(SYSDATE),'2024-03-31') AS days_diff;

days_diff
===========
64

Прибавление к дате и времени

DATEADD(datepart, quantity, value)
Поддерживает date, time, timetz или timestamp
Quantity может быть отрицательным для вычитания

-- Add week to a date based on 
-- SYSDATE of 2024-01-27 20:05:55.976353
SELECT TRUNC(SYSDATE) AS todays_date,
       TRUNC(DATEADD(week, 1, SYSDATE)) AS next_weeks_date;

todays_date | next_weeks_date
============|==================
2024-01-27  | 2024-02-03

Прибавление к дате и времени: нюансы

При добавлении месяцев в високосный год возвращается последний день месяца

-- Add year by months to a date
SELECT DATEADD(month, 12, '2024-02-29');

2025-02-28 00:00:00

При добавлении лет в високосный год возвращается следующий день

-- Add year by year to a date
SELECT DATEADD(year, 1, '2024-02-29');

2025-03-01 00:00:00

Давайте потренируемся!

Введение в Redshift