Нитья-йога определяется суммой сидерических долгот Солнца и Луны: круг делится на двадцать семь частей, и каждая часть — одна йога. Каждая из двадцати семи — от Vishkambha до Vaidhriti — длится чуть меньше суток, и они важны для элективной астрологии: Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda и Atiganda традиционно избегают, а йоги Siddhi, Siddha, Shubha, йоги класса Amrita и Sukarma, наоборот, ищут. Эндпоинт принимает одну йогу по названию и возвращает все её наступления за календарный год.
`yoga_name` чувствителен к регистру и должен в точности совпадать со значением перечисления. `year` и `timezone_as_float` задают местный год, а координаты не нужны: йога сменяется везде в один и тот же момент. Сумма двух долгот растёт примерно на 13 градусов 20 минут за 22.6 часа, поэтому каждая йога повторяется примерно четырнадцать-пятнадцать раз в год.
Ответ — `{year, yoga_name, rows}`, где `rows` — список меток времени `{start, end}` в формате ISO в UTC в хронологическом порядке. Каждая пара — истинные моменты начала и конца йоги, найденные бисекцией по сумме долгот Солнца и Луны, а не проверкой на восходе, поэтому границы точны до долей секунды.
Поля запроса
Поле
Тип
Обязательно
Примечания
timezone_as_float
number (double)
обязательный
Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.