Получение offset часового пояса

Смещение часового пояса (timezone offset) — это разница между локальным временем и UTC (Coordinated Universal Time). Значение выражается в минутах или миллисекундах и показывает, насколько локальная временная зона опережает или отстаёт от UTC.

Ключевые особенности:

  • UTC+3 означает, что локальное время на 3 часа впереди UTC
  • UTC-5 означает, что локальное время на 5 часов позади UTC
  • смещение может изменяться из-за перехода на летнее и зимнее время
  • разные даты в одной и той же зоне могут иметь разные offset

Получение offset через стандартный JavaScript

Встроенный механизм JavaScript предоставляет метод:

new Date().getTimezoneOffset()

Особенность поведения

Метод возвращает значение в минутах, причём со знаком, противоположным интуитивному:

  • положительное значение → зона позади UTC
  • отрицательное значение → зона впереди UTC

Пример:

const offset = new Date().getTimezoneOffset();
console.log(offset);

Если результат равен -180, это означает UTC+3.

Преобразование offset в часы

Для удобства часто выполняется перевод минут в часы:

const offsetMinutes = new Date().getTimezoneOffset();
const offsetHours = -offsetMinutes / 60;

Важно учитывать инверсию знака: getTimezoneOffset() возвращает обратное значение относительно UTC.

Ограничения встроенного подхода

Использование getTimezoneOffset() связано с рядом ограничений:

  • не учитывает произвольные IANA-зоны (например, Europe/Berlin)
  • работает только с локальной средой выполнения
  • не позволяет вычислять offset для других временных зон
  • зависит от системных настроек ОС

Для задач, связанных с календарями, серверной синхронизацией и мультизонными данными, этого недостаточно.

Date-fns и работа со временем

Библиотека date-fns ориентирована на манипуляции с датами, но не включает полноценную работу с часовыми поясами.

Для работы с временными зонами используется дополнительный пакет:

  • date-fns-tz

Он расширяет функциональность date-fns и позволяет:

  • получать offset для произвольной временной зоны
  • выполнять преобразования UTC ↔︎ локальное время зоны
  • учитывать DST (daylight saving time)

Получение offset через date-fns-tz

Основной инструмент для вычисления смещения:

import { getTimezoneOffset } from 'date-fns-tz';

Сигнатура:

getTimezoneOffset(timeZone: string, date?: Date | number): number

Возвращаемое значение — смещение в миллисекундах относительно UTC.

Базовый пример

import { getTimezoneOffset } from 'date-fns-tz';

const offset = getTimezoneOffset('Europe/Berlin', new Date());

console.log(offset);

Результат может отличаться в зависимости от даты из-за переходов на летнее время.

Интерпретация результата

Значение возвращается в миллисекундах:

  • положительное значение → зона позади UTC
  • отрицательное значение → зона впереди UTC

Перевод в часы:

const hours = offset / (1000 * 60 * 60);

Влияние летнего времени (DST)

Одной из ключевых особенностей является динамическое изменение offset.

Например:

  • Europe/Berlin зимой: UTC+1
  • Europe/Berlin летом: UTC+2

При вычислении:

getTimezoneOffset('Europe/Berlin', new Date('2024-01-01'))
getTimezoneOffset('Europe/Berlin', new Date('2024-07-01'))

результаты будут различаться, даже для одной и той же зоны.

Использование фиксированной даты

Передача даты критична для точности:

const winter = new Date('2024-01-15');
const summer = new Date('2024-07-15');

getTimezoneOffset('America/New_York', winter);
getTimezoneOffset('America/New_York', summer);

Такой подход позволяет учитывать реальные правила перехода времени, а не усреднённые значения.

Связь offset и UTC-конверсий

Offset используется для преобразования локального времени в UTC и обратно.

Общая логика:

  • локальное время + offset = UTC
  • UTC - offset = локальное время

В контексте date-fns-tz эти преобразования инкапсулируются функциями:

  • zonedTimeToUtc
  • utcToZonedTime

Пример ручного вычисления UTC

import { getTimezoneOffset } from 'date-fns-tz';

const date = new Date('2024-03-10T12:00:00');
const offset = getTimezoneOffset('Asia/Tokyo', date);

const utcTime = new Date(date.getTime() - offset);

Частые ошибки при работе с offset

Игнорирование DST

Использование фиксированного смещения (например, UTC+2) приводит к ошибкам в период перехода на летнее время.

Путаница знаков

Разные API используют разную систему знаков:

  • getTimezoneOffset() (JS) — обратный знак
  • date-fns-tz — стандартное направление относительно UTC

Использование локального времени вместо IANA-зоны

Передача только смещения без зоны:

'+03:00'

лишает возможности корректно обработать сезонные изменения.

Практическая модель вычислений

При работе с временными зонами устойчивой считается следующая модель:

  1. фиксируется IANA-зона
  2. выбирается конкретная дата
  3. вычисляется offset через date-fns-tz
  4. выполняются преобразования UTC ↔︎ zoned time

Поведение на границах суток

При переходах через полночь offset может влиять на:

  • дату события
  • день недели
  • интервал между временными метками

Особенно это заметно при сравнении дат в разных зонах.

Использование в серверных приложениях

На сервере, где системная зона может отличаться от пользовательской, offset становится ключевым параметром синхронизации:

  • хранение времени в UTC
  • вычисление локального отображения через zone + offset
  • унификация логики для разных регионов

Итоговая модель применения

Работа со смещением часового пояса в связке date-fns и date-fns-tz опирается на три уровня:

  • системный offset (JavaScript)
  • зональный offset (IANA через date-fns-tz)
  • дата-зависимый offset (с учётом DST)
Оглавление