Гайды

Как работать с часовыми поясами в приложении — 5 шагов, чтобы дата не съезжала

Иллюстрация: один поток данных расходится на несколько настенных часов

Баг с часовыми поясами не падает с ошибкой. Он просто тихо показывает не ту дату — и ты узнаёшь об этом от пользователя из другой страны через месяц.

Хорошая новость: чинится это не хитростью, а дисциплиной. Пять шагов, каждый занимает минуты. Дальше — по порядку, с кодом.

Если слово UTC пока ничего не говорит — сначала загляни в разбор, что такое UTC. Здесь будет только практика.

1. Заведи в базе колонку с поясом, а не без

Самая частая ошибка — на этапе схемы. В Postgres два похожих типа, и разница между ними огромная:

created_at timestamp      -- голые цифры, пояс молча выбрасывается
created_at timestamptz    -- момент времени, приводится к UTC

Бери timestamptz. Он переводит входящее значение в UTC и хранит именно момент, а не «19:00 непонятно где». Исходный пояс он при этом не запоминает — и это правильно, момент от пояса не зависит.

Строка для новой таблицы:

create table orders (
  id bigserial primary key,
  created_at timestamptz not null default now()
);

Если таблица уже есть — это отдельная миграция:

alter table orders
  alter column created_at type timestamptz
  using created_at at time zone 'UTC';

Обрати внимание на using: ты явно говоришь, как читать старые цифры. Без этой строчки база подставит пояс сервера — и весь исторический архив уедет.

2. Отдавай наружу ISO 8601 с буквой Z

Из API время должно уходить в одном формате: 2026-08-20T21:30:00Z. Финальная Z означает «это уже UTC».

res.json({ createdAt: order.createdAt.toISOString() })
// "2026-08-20T21:30:00.000Z"

Никогда не отдавай наружу готовую строку вида "20.08.2026 21:30". Она красивая, но бесполезная: клиент не знает, чьё это время, и починить уже нечем.

Правило простое: форматирование — работа последней мили. Пока данные едут по проводам, они остаются моментом.

3. Превращай момент в текст только в браузере

Только клиент знает, где сидит человек. Поэтому форматируем там:

const fmt = new Intl.DateTimeFormat("ru-RU", {
  dateStyle: "short",
  timeStyle: "short",
});

fmt.format(new Date("2026-08-20T21:30:00Z"));
// в Москве -> "21.08.2026, 00:30"
// в Лос-Анджелесе -> "20.08.2026, 14:30"

Пояс не указан — значит, взялся системный. Это то, что нужно в 90 % случаев.

Ничего не подключаешь: Intl встроен в браузер и в Node. Библиотеки для дат тут нужны редко.

Там же рядом лежит и относительное время, которое обычно пишут руками:

new Intl.RelativeTimeFormat("ru", { numeric: "auto" }).format(-5, "minute")
// "5 минут назад"

Оно тоже знает про склонения и про все языки сразу. Считать разницу в минутах придётся самому, а вот подбирать окончания — уже нет.

4. Дай пользователю переопределить пояс

Системный пояс верен почти всегда. Почти — потому что человек в командировке, а встречи планирует по домашнему времени.

Сначала определи текущий и покажи его как значение по умолчанию:

new Intl.DateTimeFormat().resolvedOptions().timeZone
// "Europe/Moscow"

Сохрани выбор в профиле — строкой с названием зоны, "Europe/Moscow", а не смещением "+3". Смещение живёт до ближайшего перевода стрелок, название — это правило, которое обновляется вместе с системой.

Дальше просто подставляй сохранённое в timeZone:

new Intl.DateTimeFormat("ru-RU", {
  dateStyle: "short",
  timeStyle: "short",
  timeZone: user.timeZone,
}).format(date)

5. Проверь на поясах, где разница — сутки

Тестировать в своём поясе бесполезно: у тебя всё сойдётся. Нужны края шкалы.

Возьми Kiritimati (UTC+14) и Niue (UTC−11) — между ними ровно сутки. Один и тот же момент:

TZ=Pacific/Kiritimati node -e 'console.log(new Date("2026-08-20T21:30:00Z").toLocaleString("ru-RU"))'
# 21.08.2026, 11:30:00

TZ=Pacific/Niue node -e 'console.log(new Date("2026-08-20T21:30:00Z").toLocaleString("ru-RU"))'
# 20.08.2026, 10:30:00

Разные даты. Если в интерфейсе где-то захардкожена «сегодняшняя» дата, на этих двух прогонах она разъедется — и ты увидишь баг сам, а не от пользователя.

Браузер проверяется так же: в DevTools открой панель Sensors и подмени Location — там же меняется пояс.

И заодно вспомни про задачи по расписанию: на сервере крон почти всегда идёт по UTC. «Отчёт в 9 утра» у тебя окажется в полдень, если не пересчитать.

Что получится

После пяти шагов ты получаешь приложение, в котором:

  • в базе лежат моменты, а не догадки;
  • API отдаёт однозначные строки, которые не сломает переезд сервера;
  • каждый пользователь видит своё местное время, ничего не настраивая;
  • тот, кому нужно, может пояс поменять;
  • баги с датами ловятся до релиза, на двух командах в терминале.

Главное, что стоит унести: время — это момент, а дата — это уже мнение. Хранишь моменты — спишь спокойно.

Частые вопросы

А если у меня всё в SQLite, там нет timestamptz?

В SQLite вообще нет отдельного типа для дат — их хранят строкой или числом. Правило то же: пиши ISO-строку с Z или Unix-время в секундах. Главное — договориться с собой один раз и не мешать форматы в одной колонке.

Нужна ли библиотека вроде Day.js или Luxon?

Для отображения — почти никогда, Intl справляется. Библиотека окупается, когда начинается арифметика: «прибавить месяц», «начало недели в поясе пользователя», повторяющиеся события. Тогда бери Luxon или встроенный Temporal, если он уже доступен в твоей среде.

Как хранить время встречи, которое не должно съезжать?

Отдельный случай: «занятие каждый вторник в 19:00 по местному» — это не момент, а правило. Такое хранят парой: локальное время плюс название зоны. Момент вычисляют при показе, иначе после перевода стрелок занятие уедет на час.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →