Тест с `new Date()` обычно подтверждает окружение автора, а не правило продукта. В UTC операция ещё относится к 5 октября, в Токио уже наступило 6-е. Если отчёт должен считать день по Москве, зона браузера вообще не должна тайно менять bucket.

Зафиксируйте три сущности: instant — единственную точку времени, display zone — где её показывает интерфейс, business zone — по чьим суткам строится расчёт. Ошибка появляется, когда один слой молча подменяет одну сущность другой.

Матрица начинается с границ, а не случайных дат

СценарийInstantЧто проверяет
Около UTC midnight23:59Z и 00:01ZСмена календарной даты
Большой +offset15:30ZУже следующий день локально
Отрицательный offset02:00ZЕщё предыдущий день
DST spring forwardДо/после перехода зоныНесуществующий local time
DST fall backДва instant одного local hourНеоднозначное время
Без DSTТа же дата в fixed-rule зонеОтделяет DST от общего offset

Не копируйте дату перехода из памяти: правила меняются, а IANA tz database обновляется. Выберите зоны, важные продукту, и вычислите ожидаемые значения из зафиксированной версии runtime/tzdata; в тесте сохраните конкретные instant и ожидания.

Playwright меняет timezone браузерного context

import { defineConfig } from '@playwright/test'

export default defineConfig({
  projects: [
    { name: 'utc', use: { timezoneId: 'UTC', locale: 'en-GB' } },
    { name: 'new-york', use: { timezoneId: 'America/New_York', locale: 'en-US' } },
    { name: 'tokyo', use: { timezoneId: 'Asia/Tokyo', locale: 'ja-JP' } },
  ],
})

// API fixture возвращает фиксированный instant:
// { occurredAt: '2026-10-05T23:30:00Z' }

Playwright прямо отмечает: timezoneId влияет на браузерную зону, но не на timezone test runner. Если expected string формируется Node-кодом, runner может вычислить его в другой зоне и получить самоподтверждающийся тест.

Runner и backend получают явную TZ

# Примеры отдельных запусков Node test runner
TZ=UTC npm test
TZ=America/New_York npm test
TZ=Asia/Tokyo npm test

# Не меняйте TZ посреди параллельного процесса.
# Запускайте зоны отдельными jobs/processes.

Node поддерживает базовые IANA timezone IDs через переменную `TZ`; сокращения вроде CST неоднозначны и не рекомендуются. Backend-тестам нужна собственная настройка зоны или явный параметр форматирования — browser emulation на них не влияет.

Часы и календарь подменяются разными средствами

  • Fake clock фиксирует Date.now/timers, но сам по себе не меняет timezone rules.
  • timezoneId меняет локальное представление в браузере, но не данные API.
  • Locale влияет на формат, а не определяет business timezone.
  • Offset `+03:00` описывает момент, но не будущие правила региона.
  • IANA zone `Europe/Paris` содержит правила переходов, которые обновляются вместе с tzdata.
  • Дата без offset требует договорённости; иначе разные слои интерпретируют её по-разному.

Ожидание выражает правило продукта

ПравилоВходОжидание
День магазина Europe/Moscowinstant + store zoneОдинаковый bucket у всех браузеров
Локальное время пользователяinstant + profile zoneРазные подписи, тот же instant
Срок 24 часадва instantРазница duration, не local date
До конца сутокinstant + business zoneГраница следующего local day
Введённое local timedate/time + chosen zoneЯвная обработка ambiguity

Регрессия проверяет полный маршрут времени

  1. API возвращает ISO 8601 с `Z` или явным offset.
  2. Клиент парсит instant и форматирует в заданной зоне.
  3. Фильтр дат отправляет серверу однозначные границы.
  4. Backend агрегирует по документированной business zone.
  5. CSV/export использует то же правило или явно подписывает другое.
  6. Тест повторяется после обновления runtime/tzdata на пограничной матрице.

Исправление принято, когда один instant сохраняется на всех слоях, различаются только ожидаемые представления, а календарные buckets следуют выбранной business zone. Для анализа подготовьте ISO-вход, три timezone IDs, версии браузера/Node/tzdata и ожидаемую таблицу до/после границы.

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