Если итог за 5 октября разный у двух пользователей, не сравнивайте сначала цвета и кеши дашборда. Возьмите одну операцию возле границы суток и проследите её от колонки БД до подписи на экране. На каждом шаге записывайте instant, zone и offset: именно потерянная часть обычно переносит строку в соседний день.

Отчёт должен отвечать на отдельный вопрос: «день по чьим часам?». Для бухгалтерского среза это может быть зона организации, для локальной активности — зона пользователя, для технического SLO — UTC. Автоматически брать зону ноутбука удобно для показа, но непригодно как скрытое правило расчёта.

Одна запись проходит пять преобразований

СлойЧто зафиксироватьТипичная потеря
ИсточникИсходная строка и offset/zoneЛокальное время пришло без зоны
Колонка БДТип timestamp/timestamptzInstant записан как local timestamp
Сессия SQLSHOW TimeZoneОдинаковый timestamptz показан по-разному
АгрегацияZone границы и bucketdate_trunc выполнен в session zone
API/CSVISO 8601 и offsetСериализатор отбросил Z или offset
БраузерResolved zone и Intl optionsDate форматируется в зоне устройства

PostgreSQL хранит timestamp with time zone как момент времени и выводит его в TimeZone текущей сессии. Timestamp without time zone не несёт зоны: добавленный позже offset будет предположением. Сначала проверяйте тип, а уже затем формат строки.

Граница бизнес-дня строится в выбранной зоне

SHOW TimeZone;

-- Сначала локальные границы московского бизнес-дня
-- превращаются в timestamptz, затем фильтруют instants.
SELECT count(*), sum(amount)
FROM payments
WHERE occurred_at >= TIMESTAMP '2026-10-05 00:00:00'
                     AT TIME ZONE 'Europe/Moscow'
  AND occurred_at <  TIMESTAMP '2026-10-06 00:00:00'
                     AT TIME ZONE 'Europe/Moscow';

SELECT date_trunc('day', occurred_at AT TIME ZONE 'Europe/Moscow') AS local_day,
       count(*)
FROM payments
GROUP BY local_day
ORDER BY local_day;

Полуоткрытый интервал [start, next_start) не требует придумывать «последнюю миллисекунду дня» и работает при разной точности. Полные IANA-имена вроде Europe/Moscow учитывают исторические правила. Фиксированный +03:00 — только offset; он не заменяет правила зоны для регионов с переходами и изменениями законодательства.

Разные результаты локализуют слой ошибки

  • SQL в UTC и BI отличаются — проверьте zone, добавленную в вычисляемом поле или connection session.
  • API верен, браузер сдвигает дату — проверьте парсинг строки и явный timeZone в formatter.
  • Экран верен, CSV отличается — экспорт пересчитывает период или форматирует на сервере с другой зоной.
  • Сумма равна, подпись дня другая — данные те же, но bucket label локализован повторно.
  • Расхождение появляется только весной или осенью — тестируйте DST, а не округление чисел.
  • Только один tenant отличается — ищите его business timezone и наследование настройки.

Не лечите симптом глобальным SET TIME ZONE без контракта: изменение сессии может исправить один отчёт и сломать другой. Лучше задавать зону явно в расчёте или гарантировать её на уровне подключения и тестировать это как часть конфигурации.

DST делает локальные часы неоднозначными

При переходе на летнее время некоторые локальные значения не существуют, а при обратном переходе один и тот же час встречается дважды с разными offsets. Поэтому ключ события — instant, а не текст «01:30». Для расписаний, напротив, могут понадобиться локальные часы плюс IANA zone и правило поведения при пропуске/повторе.

СценарийЧто хранитьКак проверять
Факт платежаInstant/timestamptzОдин момент во всех системах
Начало бизнес-дняLocal date + IANA zoneГраницы конвертируются в instants
Ежедневная рассылка 09:00Local time + zone + DST policyДни перехода входят в тесты
Экспорт аудитаInstant и явный offset/zone в представленииСортировка не меняется
Дата рожденияDate без времениНикакого UTC-сдвига

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

Контракт отчёта виден пользователю

  1. Назвать зону рядом с периодом: «5 октября, Europe/Moscow» или согласованное человекочитаемое имя.
  2. Передавать API instants в однозначном ISO 8601 с Z/offset, не строку без контекста.
  3. Отделить timezone расчёта bucket от timezone отображения подписи.
  4. Включить выбранную zone в cache key и параметры экспорта.
  5. Записывать в audit report query period как два UTC instants и исходную business zone.
  6. Не менять итог после автоопределения зоны браузера без явного продукта решения.

В браузере Intl.DateTimeFormat умеет принимать timeZone явно. Если параметр не задан, результат зависит от окружения пользователя. Это допустимо для подписи «ваше местное время», но не для пересчёта общего финансового периода.

Контрольный набор содержит границы, а не случайные даты

Возьмите события за секунду до и после полуночи business zone, ровно на границе интервала, в день DST-перехода и с клиентом в другой зоне. Сравните SQL, API JSON, UI и CSV. Везде должны совпасть состав строк и сумма; подписи могут различаться только там, где продукт это явно обещает.

Для разбора сохраните DDL временных колонок, SHOW TimeZone из реального подключения, SQL агрегации, две границы периода, фрагмент JSON и настройки formatter без персональных данных. Одной подписи на скриншоте недостаточно: нужен instant спорной записи на каждом участке.

Проверенные источники