Тест с `new Date()` обычно подтверждает окружение автора, а не правило продукта. В UTC операция ещё относится к 5 октября, в Токио уже наступило 6-е. Если отчёт должен считать день по Москве, зона браузера вообще не должна тайно менять bucket.
Зафиксируйте три сущности: instant — единственную точку времени, display zone — где её показывает интерфейс, business zone — по чьим суткам строится расчёт. Ошибка появляется, когда один слой молча подменяет одну сущность другой.
Матрица начинается с границ, а не случайных дат
| Сценарий | Instant | Что проверяет |
|---|---|---|
| Около UTC midnight | 23:59Z и 00:01Z | Смена календарной даты |
| Большой +offset | 15:30Z | Уже следующий день локально |
| Отрицательный offset | 02: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/Moscow | instant + store zone | Одинаковый bucket у всех браузеров |
| Локальное время пользователя | instant + profile zone | Разные подписи, тот же instant |
| Срок 24 часа | два instant | Разница duration, не local date |
| До конца суток | instant + business zone | Граница следующего local day |
| Введённое local time | date/time + chosen zone | Явная обработка ambiguity |
Регрессия проверяет полный маршрут времени
- API возвращает ISO 8601 с `Z` или явным offset.
- Клиент парсит instant и форматирует в заданной зоне.
- Фильтр дат отправляет серверу однозначные границы.
- Backend агрегирует по документированной business zone.
- CSV/export использует то же правило или явно подписывает другое.
- Тест повторяется после обновления runtime/tzdata на пограничной матрице.
Исправление принято, когда один instant сохраняется на всех слоях, различаются только ожидаемые представления, а календарные buckets следуют выбранной business zone. Для анализа подготовьте ISO-вход, три timezone IDs, версии браузера/Node/tzdata и ожидаемую таблицу до/после границы.