Добавление переменного числа часов к дате в PostgreSQL

Быстрый ответ

Для того чтобы прибавить часы к временной метке в PostgreSQL, воспользуйтесь следующим запросом:

-- Прогнозирование будущего
SELECT your_date + INTERVAL '1 hour' * hours_to_add;

В данном запросе your_date — это сама временная метка, а hours_to_add — количество часов, которое вы хотите прибавить. Никаких лишних действий, мы моментально переносимся в будущее!

Понимание типов данных

Когда проводится сложение с применением типа данных interval и оператора +, тип результата зависит от your_date. Если your_date — это метка времени (timestamp), то результатом будет timestamp. Если же это date, то в результате получится метка времени без учета часового пояса. Для hours_to_add всегда используйте числовые значения, чтобы исключить возможные ошибки при выполнении запроса.

Работа с дробными часами

Для добавления дробных часов, например 1.5, примените один из следующих подходов:

-- Точность – залог успеха!
SELECT your_date + make_interval(hours => hours_to_add);
-- ИЛИ
SELECT your_date + (interval '1 hour' * hours_to_add);

При использовании второго варианта подразумевается, что значение hours_to_add является числом с плавающей точкой. This will allow fractional hours to be accounted for.

Сокращения в записи

Для более простого и наглядного представления запроса можно использовать сокращенное обозначение "1 hour" как "1h":

-- А вдруг мы отправимся в прошлое?
SELECT your_date + interval '1h' * hours_to_add;

Такой подход сделает запросы более компактными и легкими для чтения, особенно когда вы работаете с несколькими временными интервалами.

Визуализация

Представьте, что вы находитесь на железнодорожном вокзале, где каждый отходящий поезд соответствует временной метке TIMESTAMP в PostgreSQL. У вас есть особенный билет, который позволяет отложить отправление на несколько часов по вашему усмотрению:

Ваш поезд (🚂): Отправление в 12:00
Специальный билет: +3 часа

Чтобы использовать такой билет, вам достаточно выполнить:

SELECT '12:00'::timestamp + INTERVAL '3 hour';

Теперь ваш поезд отправится в:

Ваш поезд (🚂): Отправление перенесено на 15:00

Эта визуализация наглядно демонстрирует, как операции с датами и временем позволяют "перемещать" время вперед, прямо как стрелки на часах.

Работа со сложными случаями

Работа с нетипичными интервалами

Бывает необходимо прибавить нестандартное количество часов, которое не составляет целое число. В этой ситуации может помочь функция make_interval:

-- Почему мы должны ограничиваться стандартными временными интервалами?
SELECT your_date + make_interval(hours => FLOOR(start_time));

Если вам нужно добавить дробное значение часов, переведите их в минуты:

SELECT your_date + interval '1' minute * FLOOR(start_time * 60);

Подробнее об этом расскажет наш спикер на видео

Учет часовых поясов

При добавлении времени к метке с учетом часового пояса (timestamp with time zone) в результате будет отображено время в UTC. Чтобы правильно работать с локальными часовыми поясами, сначала произведите соответствующее преобразование часового пояса, а затем выполните сложение.

Распространенные ошибки и как их избежать

Избегайте переполнения метки времени

Добавление большого количества часов может вызвать переполнение пределов типа данных timestamp в PostgreSQL. Проверяйте вводимые значения, чтобы не "вылететь" за рамки временного пространства.

Обеспечение точности

Операции с типом данных «число с плавающей точкой» могут приносить мелкие неточности. Для выполнения точных операций лучше использовать целые числа или приводить значения к числовому типу, особенно если величина часов может быть дробной.

Работа с летним временем

Операции с timestamp with time zone в период перехода на летнее время могут быть ошибочны. Для корректной работы с изменениями времени используйте конструкцию AT TIME ZONE.

Полезные материалы

1. PostgreSQL: Документация: 9.9. Функции и операторы даты/времени
2. PostgreSQL: Документация: 8.5. Типы данных даты/времени
3. PostgreSQL – Функции и операторы даты/времени
4. PG Casts
5. Работа с датами и временем в PostgreSQL – Вики PostgreSQL