Назад к документации

Система часовых поясов

Система часовых поясов и LMT

Наш API оснащен надежным и исторически точным двигателем time-resolution. Он автоматически обрабатывает сложности изменения часовых поясов, летнего времени (DST) и исторического перехода от местного среднего времени (LMT) к стандартному времени.

Руководство по сравнению: Концептуальное объяснение того, почему это важно (с примерами), см. в нашей Часовые пояса и руководство по LMT.

Параметр tz_str

Большинство endpoints западной астрологии (/natal, /transits, /synastry) принимают необязательный параметр tz_str. Он управляет тем, как интерпретируется переданное локальное время.

ЗначениеПоведение
"AUTO"Рекомендуется. Движок использует предоставленные широту/долготу и дату для определения правильного часового пояса. Он автоматически определяет, является ли дата исторической (pre-standardization), и при необходимости использует LMT.
"Europe/Paris"Явный идентификатор часового пояса IANA. Заставляет движок использовать это конкретное правило часового пояса.
Предупреждение. Использование современных идентификаторов для древних дат может привести к неверным расчетам LMT.
"UTC"Считает введенное время универсальным координированным временем. Используйте это только в том случае, если вы уже самостоятельно перевели время рождения в UTC.

Общие идентификаторы часовых поясов (IANA)

Параметр tz_str требует корректный формат Area/Location. Общие регионы вроде US или Asia не поддерживаются.

Действительные примеры

  • "America/New_York"
  • "America/Los_Angeles"
  • "Europe/London"
  • "Asia/Tokyo"
  • "Asia/Kolkata"
  • "Australia/Sydney"

Недействительно (не использовать)

  • "US" (слишком расплывчато)
  • "Eastern Standard Time" (неоднозначно)
  • "Asia" (не часовой пояс)
  • "Paris" (нужно использовать Europe/Paris)

Историческая точность (LMT)

До принятия стандартного времени (конец 19 - начало 20 века) в местах использовалось местное среднее время (LMT). LMT строго определяется долготой: 4 минуты на градус.

Когда используется tz_str="AUTO":

  • Механизм сверяет год рождения с базой данных дат принятия часового пояса для этого региона.
  • Если дата pre-standardization, он автоматически вычисляет LMT на основе lng.
  • Если дата post-standardization, он ищет явное смещение (включая историческое время войны/летнее время) для этой зоны.

Стандарты китайской астрологии

Endpoints китайского BaZi и Vedic Reference обычно используют более точный параметр time_standard вместо tz_str.

civil

Необработанное время. Подходит для большинства стандартных приложений-календарей и базовых калькуляторов.

true_solar

Рекомендуется для BaZi. Регулирует время на часах для вашей конкретной долготы относительно меридиана часового пояса. Необходим для правильного расчета часовых столпов.

true_solar_absolute

Чистое астрономическое солнечное время (время солнечных часов). Используется только для очень конкретных исследовательских целей.