Неправильный локальный формат редко исправляется перестановкой `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_at | timestamptz | обычно ничего, вывод в выбранной зоне |
| birthday | date | calendar по правилам продукта |
| встреча 09:00 в регионе | timestamptz + zone id | IANA zone для повторов/редактирования |
| store opens at 09:00 | time + 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
- Проверить один instant в `Pacific/Honolulu`, `UTC`, `Europe/Moscow` и `Pacific/Kiritimati`: календарный день может различаться законно.
- Проверить `ru-RU`, `en-US`, `en-GB`, locale с другим порядком полей и RTL locale.
- Проверить date-only 1 января и 31 декабря без преобразования в предыдущий день.
- Проверить момент до и после сезонного перехода в зоне, где он существует.
- Сравнить SSR HTML и первый клиентский рендер с явными locale/timeZone.
- Проверить сортировку по исходному instant, а не по локализованной строке.
- Проверить экспорт: машинная колонка ISO и отдельная человекочитаемая колонка при необходимости.
Тест не должен утверждать единственную строку для всех платформ, если продукт разрешает locale defaults. Лучше сравнить `formatToParts`: год, месяц и день соответствуют ожидаемому instant и зоне, а порядок выбирает локаль. Исправление готово, когда смысл поля документирован в API/схеме базы, форматтер получает явные настройки и крайние зоны больше не создают случайный сдвиг.