Menu

PostgreSQL timestamp или timestamptz (with time zone)

timestamptz хранит момент времени и показывает его в часовом поясе сессии; timestamp хранит время по часам без пояса. Ни один не хранит пояс, который вы указали. Почти всегда берите timestamptz.

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

В PostgreSQL два типа меток времени. timestamptz (timestamp with time zone) хранит точный момент: при вводе переводит его в UTC, а при выводе показывает в часовом поясе сессии. timestamp (timestamp without time zone) хранит дату и время по часам без пояса. Ни один из них не хранит пояс, который вы указали. Для всего, что произошло в конкретный момент, используйте timestamptz.

Один и тот же ввод даёт 2026-03-01 12:00:00 и 2026-03-01 21:00:00+09. Значение timestamptz это тот же момент, что и раньше, только теперь показанный по токийскому времени. У значения timestamp нет пояса, из которого его можно перевести, поэтому оно не меняется.

Что происходит с часовым поясом во вводе

Если во вводе есть смещение, timestamptz использует его, чтобы найти момент. timestamp молча его отбрасывает:

plain равно 2026-03-01 12:00:00, а +02 выброшено. with_zone равно 2026-03-01 10:00:00+00, это тот же момент в UTC. Именно так время и съезжает на несколько часов: приложение отправляет строку ISO со смещением в столбец timestamp, и смещение пропадает.

Когда какой тип нужен

Что хранитсяТип
Создано, обновлено, оплачено, вход в системуtimestamptz
Запланированное местное время, которое идёт по местным часам («каждый день в 9:00 в поясе пользователя»)timestamp плюс столбец с именем пояса
Календарный день без времениdate
Продолжительностьinterval

Оба типа занимают 8 байт и хранят микросекунды. Пояс сессии задаётся через SET TIME ZONE 'Europe/Paris'. Используйте полные имена поясов, а не сокращения вроде EST: сокращение означает фиксированное смещение, которое не учитывает летнее время.

Перевод между поясами через AT TIME ZONE

AT TIME ZONE работает в обе стороны. Для timestamptz он возвращает время по часам в этом поясе как timestamp. Для timestamp он читает значение как местное время в этом поясе и возвращает момент timestamptz.

Полдень по UTC в июле это 08:00 в Нью-Йорке, а 9:00 в Париже это 07:00 по UTC. Первая форма нужна, чтобы показать время в поясе пользователя, вторая, чтобы превратить введённое пользователем местное время в момент.

Летнее время и арифметика интервалов

Прибавление interval '1 day' к timestamptz сохраняет то же местное время по часам при переходе на летнее время. Прибавление '24 hours' добавляет ровно столько часов. В США часы переводят вперёд 8 марта 2026 года:

Первое выражение даёт 2026-03-08 12:00:00-04, второе 2026-03-08 13:00:00-04. Результат зависит от часового пояса сессии, поэтому в коде с арифметикой дат задавайте его явно.

Текущее время

now() и current_timestamp возвращают время начала текущей транзакции как timestamptz, одно и то же значение для всех строк, которые затрагивает оператор. clock_timestamp() возвращает реальное время при каждом вызове. current_date возвращает date, а localtimestamp возвращает timestamp. Типичный столбец выглядит так: created_at timestamptz NOT NULL DEFAULT now().

Перевод столбца timestamp в timestamptz

Если существующий столбец timestamp хранит время в UTC, преобразуйте его через USING ... AT TIME ZONE 'UTC', чтобы значения читались как UTC, а не в поясе сессии:

Теперь значение равно 2026-01-15 09:30:00+01 и показано по берлинскому времени. Изменение перезаписывает таблицу, поэтому на большой таблице запускайте его в спокойное время (смена типа описана на странице ALTER TABLE). Функции вроде date_trunc, extract и age собраны на странице о функциях дат, а полные форматы ввода есть в главе о типах даты и времени.

Часто задаваемые вопросы

Хранит ли timestamptz часовой пояс в PostgreSQL?

Нет. Он переводит ввод в UTC и хранит только этот момент. Указанный пояс теряется, а при выводе значение показывается в поясе из настройки сессии TimeZone. Если пояс понадобится позже, храните его имя в отдельном столбце text.

Чем now() отличается от clock_timestamp()?

now() (то же, что current_timestamp) возвращает время начала текущей транзакции, поэтому оно одинаково для всех строк и операторов в ней. clock_timestamp() возвращает реальное время в момент вызова и меняется даже в пределах одного оператора.

Как получить текущую дату в PostgreSQL?

current_date возвращает сегодняшнюю дату в часовом поясе сессии. now()::date даёт то же самое, а localtimestamp возвращает текущие дату и время как timestamp без пояса.

Сколько места занимает timestamp в PostgreSQL?

8 байт и для timestamp, и для timestamptz, с точностью до микросекунды. date занимает 4 байта.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать