Неправильный локальный формат редко исправляется перестановкой `DD` и `MM` в строке. Сначала определите смысл поля. Момент платежа — это instant, который можно показать в разных часовых поясах; день рождения — календарная дата без часового пояса; «в 09:00 по Москве» — локальное время вместе с зоной и правилами перехода времени.

Для одного проблемного значения сохраните четыре факта: что пришло по API, какой тип хранится в базе, какие `locale` и `timeZone` использовал форматтер, что вернул `formatToParts`. Это обычно сразу показывает, где произошёл сдвиг: при парсинге, преобразовании зоны или только при отображении.

Один экран может содержать три разных типа даты

СмыслПример передачиКак отображать
точный момент события2026-10-07T06:30:00Zв зоне пользователя или явно указанной зоне
календарная дата2026-10-07как year/month/day без конвертации через UTC instant
локальное расписание2026-10-07 09:00 + Europe/Moscowс IANA zone и правилами продукта
интервал/длительность5400 секундне как Date, а как duration
месяц отчёта2026-10как calendar period без придуманного первого дня

Ошибка на день часто начинается с того, что строку `2026-10-07` превращают в JavaScript `Date`. Стандартный date-only формат при `Date.parse` подразумевает UTC; в отрицательном часовом поясе это ещё предыдущий вечер. Если значение означает календарный день, держите отдельные year/month/day или тип PlainDate, а не выдуманный момент полуночи.

Locale и timeZone управляют разными вещами

`locale` выбирает язык, порядок полей, названия месяцев, цифры и часовой цикл. `timeZone` определяет, какой локальной датой и временем станет конкретный instant. Русский язык не означает автоматически `Europe/Moscow`, а браузер с английским интерфейсом может находиться в Москве. Оба решения должны следовать продуктовым правилам.

const instant = new Date('2026-10-07T06:30:00Z');

const formatter = new Intl.DateTimeFormat('ru-RU', {
  dateStyle: 'long',
  timeStyle: 'short',
  timeZone: 'Europe/Moscow',
});

console.log(formatter.format(instant));
console.table(formatter.formatToParts(instant));

MDN отмечает, что `Intl.DateTimeFormat` без аргументов использует locale и time zone окружения. Это удобно для простого клиентского интерфейса, но опасно для server-side rendering: сервер может отформатировать UTC/en-US, а браузер — Europe/Moscow/ru-RU, после чего hydration увидит другой текст.

Неоднозначную строку нельзя надёжно распарсить

`07/10/2026` означает 7 октября для одного пользователя и 10 июля для другого. `Date.parse` гарантирует стандартный date-time формат, а поддержка других форматов зависит от реализации. API должен передавать ISO 8601 с `Z` или offset для instant, либо отдельную date-only строку по задокументированному контракту.

// Instant: однозначный момент
const createdAt = new Date('2026-10-07T06:30:00Z');

// Date-only: разбираем поля, не создавая UTC midnight
function parseIsoDateOnly(value) {
  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
  if (!match) throw new Error('invalid_date_only');
  return { year: +match[1], month: +match[2], day: +match[3] };
}

const birthday = parseIsoDateOnly('1993-04-12');

Не исправляйте проблему `new Date(value + 'T12:00:00')`: полдень лишь уменьшает шанс сдвига и скрывает неверную модель. Для date-only форматируйте поля календаря или используйте API/библиотеку с типом plain date. Для instant передавайте зону в `Intl`, не вырезайте первые десять символов ISO после конвертации.

База данных тоже различает типы

В PostgreSQL `date` хранит календарную дату. `timestamp with time zone` преобразует входной момент в UTC и при выводе показывает его в текущем параметре `TimeZone`; исходное название зоны при этом не сохраняется. `timestamp without time zone` не является универсальным UTC timestamp и игнорирует zone indication после выбора этого типа.

Поле продуктаТип PostgreSQLДополнительные данные
created_attimestamptzобычно ничего, вывод в выбранной зоне
birthdaydatecalendar по правилам продукта
встреча 09:00 в регионеtimestamptz + zone idIANA zone для повторов/редактирования
store opens at 09:00time + business zoneдни недели и исключения
billing_monthотдельные year/monthне timestamp

Для будущего расписания одного offset вроде `+03:00` недостаточно там, где действуют переходы или меняются правила. Храните IANA zone (`Europe/Paris`, `America/New_York`) и пересчитывайте конкретный instant по актуальным правилам. Offset описывает один момент, zone — набор правил.

Формат задают намерением, а не вручную собранной маской

Unicode CLDR содержит локальные шаблоны даты, времени, часового цикла и названия зон. `Intl.DateTimeFormat` использует эти данные, поэтому `dateStyle`, `timeStyle` или семантический набор полей лучше ручного `day + '/' + month`. Ручная маска не знает грамматическую форму месяца, направление текста, локальные цифры и предпочтение 12/24 часов.

function formatOrderTime(iso, preferences) {
  const date = new Date(iso);
  if (Number.isNaN(date.getTime())) throw new Error('invalid_instant');

  return new Intl.DateTimeFormat(preferences.locale, {
    year: 'numeric',
    month: 'short',
    day: 'numeric',
    hour: '2-digit',
    minute: '2-digit',
    hour12: preferences.hour12,
    timeZone: preferences.timeZone,
    timeZoneName: 'short',
  }).format(date);
}
  • Передавайте locale из настройки интерфейса, а не угадывайте его по IP.
  • Передавайте timeZone из настройки пользователя/объекта или явно используйте зону продукта.
  • Для машинных атрибутов и API оставляйте ISO, локализуйте только видимый текст.
  • Кеш форматтера ключуйте минимум по locale, timeZone и набору options.
  • Если браузер не поддерживает нужную locale/zone, определите fallback и наблюдайте его метрикой.

SSR получает те же настройки, что и браузер

Есть три устойчивых стратегии. Первая — сервер знает locale/timeZone пользователя и форматирует с ними. Вторая — сервер отдаёт ISO в `<time datetime>` и клиент форматирует после загрузки, приняв краткое изменение текста. Третья — сервер и первый клиентский рендер используют фиксированную зону, а персональный формат появляется после hydration. Важно выбрать одну стратегию, а не полагаться на окружение.

Для публичной страницы полезен `<time datetime="2026-10-07T06:30:00Z">...</time>`: машинное значение остаётся однозначным, а видимый текст локализован. Не кладите локализованную строку обратно в API и не пытайтесь затем распарсить её для сортировки.

Регрессия живёт на границе суток и DST

  1. Проверить один instant в `Pacific/Honolulu`, `UTC`, `Europe/Moscow` и `Pacific/Kiritimati`: календарный день может различаться законно.
  2. Проверить `ru-RU`, `en-US`, `en-GB`, locale с другим порядком полей и RTL locale.
  3. Проверить date-only 1 января и 31 декабря без преобразования в предыдущий день.
  4. Проверить момент до и после сезонного перехода в зоне, где он существует.
  5. Сравнить SSR HTML и первый клиентский рендер с явными locale/timeZone.
  6. Проверить сортировку по исходному instant, а не по локализованной строке.
  7. Проверить экспорт: машинная колонка ISO и отдельная человекочитаемая колонка при необходимости.

Тест не должен утверждать единственную строку для всех платформ, если продукт разрешает locale defaults. Лучше сравнить `formatToParts`: год, месяц и день соответствуют ожидаемому instant и зоне, а порядок выбирает локаль. Исправление готово, когда смысл поля документирован в API/схеме базы, форматтер получает явные настройки и крайние зоны больше не создают случайный сдвиг.

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