Получение информации о часовом поясе

В библиотеке Luxon информация о временной зоне тесно связана с объектом DateTime, который всегда содержит контекст зоны, в которой интерпретируется момент времени. По умолчанию используется системная временная зона среды выполнения (браузер или Node.js), основанная на данных операционной системы и API Intl.

Основной способ получения зоны текущего окружения:

import { DateTime } from "luxon";

const now = DateTime.now();

console.log(now.zoneName);

zoneName возвращает строковый идентификатор временной зоны в формате IANA, например:

  • "Europe/Paris"
  • "Asia/Almaty"
  • "UTC"

Если среда не предоставляет полноценную IANA-зону, Luxon может отобразить смещение в виде фиксированной зоны.

Дополнительно доступен объект зоны:

console.log(now.zone);

zone содержит внутреннее представление зоны, реализующее интерфейс Luxon Zone, через который вычисляются смещения и правила перехода на летнее время.

IANA временные зоны и их значение

Luxon опирается на стандарт IANA Time Zone Database. Каждая зона представляет собой не просто смещение, а набор правил:

  • исторические изменения смещения
  • переходы на летнее время
  • региональные корректировки

Пример корректной зоны:

DateTime.local().setZone("Asia/Tokyo");

При этом Luxon не хранит собственный список зон, а делегирует проверку и работу встроенному Intl API.

Определение текущей зоны системы

Для явного получения системной временной зоны используется тот же объект DateTime, но важно понимать, что это не фиксированное смещение, а динамическая зона:

const systemZone = DateTime.local().zoneName;

Также можно зафиксировать текущее смещение:

const offsetMinutes = DateTime.local().offset;

offset возвращает разницу с UTC в минутах на текущий момент времени. Например:

  • -180 для UTC+3
  • 540 для UTC-9

Отображение смещений и человекочитаемые названия

Luxon предоставляет дополнительные свойства для анализа временной зоны:

const dt = DateTime.now();

console.log(dt.offsetNameShort);
console.log(dt.offsetNameLong);

Типичные значения:

  • GMT+6 (короткое представление)
  • Gulf Standard Time (длинное представление)

Эти значения формируются через Intl.DateTimeFormat и зависят от локали системы.

Проверка и валидация временных зон

Luxon предоставляет утилиты через объект Info для работы с зонами.

Проверка корректности IANA-зоны:

import { Info } from "luxon";

Info.isValidIANAZone("Asia/Almaty");

Результат:

  • true — зона существует и поддерживается
  • false — строка не соответствует IANA-формату или отсутствует в базе

Эта проверка полезна перед установкой пользовательских значений:

if (Info.isValidIANAZone(zoneString)) {
  DateTime.local().setZone(zoneString);
}

Нормализация временных зон

Входящие строки временных зон могут быть нестабильными: разные API, пользовательский ввод или базы данных часто используют альтернативные обозначения.

Luxon предоставляет механизм нормализации:

Info.normalizeZone("utc");

Примеры нормализации:

  • "utc" → "UTC"
  • "gmt+3" → фиксированное смещение
  • "Europe/Moscow" → каноническая форма IANA

Нормализация важна при построении систем, где временная зона приходит из внешних источников.

Определение поддержки зон в среде выполнения

Не все среды одинаково поддерживают полноценную работу с временными зонами. Проверка возможностей выполняется через Info.features():

Info.features().zones;

Значение:

  • true — поддержка IANA-зон доступна
  • false — доступна только базовая работа со смещениями

В современных Node.js и браузерах с актуальным Intl значение почти всегда равно true.

Установка и получение зоны в объекте DateTime

Информация о временной зоне тесно связана с методами преобразования даты:

const dt = DateTime.now().setZone("Asia/Almaty");

console.log(dt.zoneName);

После вызова setZone объект перестраивает внутреннюю модель времени, сохраняя момент в UTC и пересчитывая локальное представление.

Сравнение зон:

const a = DateTime.now().setZone("UTC");
const b = DateTime.now().setZone("Asia/Almaty");

console.log(a.zoneName);
console.log(b.zoneName);

Разница между системной зоной и фиксированным смещением

Luxon различает:

  1. Системную IANA-зону

    • учитывает DST
    • зависит от региона
    • динамическая

  2. Фиксированное смещение

    • постоянное значение относительно UTC
    • не учитывает летнее время

Пример фиксированной зоны:

DateTime.fromObject(
  { hour: 10 },
  { zone: "UTC+6" }
);

Такие зоны полезны для протоколов и данных, где важна стабильность, а не региональные правила.

Определение перехода на летнее время

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

const dt = DateTime.now();

console.log(dt.isInDST);

Значение:

  • true — активен переход на летнее время
  • false — стандартное время

Это свойство зависит от выбранной IANA-зоны и текущей даты.

Работа с системной зоной по умолчанию

Luxon использует глобальную настройку:

import { Settings } from "luxon";

Settings.defaultZoneName = "Europe/Paris";

После этого все создаваемые DateTime без явного указания зоны будут использовать заданное значение.

Получение текущего значения:

console.log(Settings.defaultZoneName);

Внутреннее представление зоны

Объект zone внутри DateTime содержит:

  • идентификатор зоны
  • смещение для текущего момента
  • правила DST (если доступны)
  • методы форматирования

Пример доступа:

const dt = DateTime.now();

console.log(dt.zone.name);
console.log(dt.zone.offset(dt.ts));

Работа с неизвестными или некорректными зонами

При передаче некорректной строки Luxon не всегда выбрасывает ошибку, а может использовать fallback:

DateTime.now().setZone("Invalid/Zone");

Поведение зависит от окружения:

  • может быть заменено на UTC
  • может быть преобразовано в фиксированное смещение
  • может быть проигнорировано

Поэтому проверка через Info.isValidIANAZone остаётся обязательной при внешнем вводе.

Получение информации о текущем UTC-эквиваленте

Любая временная зона в Luxon всегда может быть приведена к UTC:

const dt = DateTime.now();
const utc = dt.toUTC();

console.log(utc.zoneName);

Результат всегда:

  • "UTC"

Это позволяет унифицировать хранение и сравнение времени независимо от локальных зон.

Особенности работы через Intl API

Luxon не содержит собственной базы временных зон. Все вычисления зависят от:

  • Intl.DateTimeFormat
  • системной базы часовых поясов
  • возможностей окружения Node.js или браузера

По этой причине поведение:

  • может отличаться между старыми и новыми версиями среды
  • зависит от локализации системы
  • требует актуальной платформы для корректных IANA-данных
Оглавление