curl -X POST https://api.occultapi.com/api/astro/tamil_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Тамильский календарь солнечный, а не лунный, и этим он отличается от большинства других региональных календарей из представленных здесь. Месяц начинается в момент вхождения Солнца в новый сидерический знак, поэтому двенадцать месяцев (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi и Panguni) следуют за положением Солнца и каждый год начинаются примерно в одни и те же григорианские даты; Chithirai открывает год около 14 апреля. Первый день месяца определяется по правилу захода Солнца: если ингрессия Солнца приходится на время между восходом и заходом, первым днём считается этот же календарный день, а если после захода — следующий. Календари телугу, маратхи, гуджарати и каннада, напротив, отсчитывают месяцы от новолуния или полнолуния. Передайте `year` вместе с `latitude`, `longitude` и `timezone_as_float`. Восход и заход Солнца, по которым определяется каждый обрядовый день, рассчитываются для этих координат, поэтому при смене места событие может сдвинуться на день. Ответ — `{year, events}` за весь григорианский год, где каждое событие — `{name, date, tamil_month, tamil_day}`, т. е. григорианская дата и положение внутри тамильского месяца. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai и остальные праздники указаны под своими тамильскими названиями. Часть этих праздников — те же лунные титхи, что рассчитывает основной движок индуистских праздников: их находят по тамильскому названию, а затем дату определяют по их собственному правилу соблюдения (восход Солнца, мадхьяхна, апарахна, нишита, прадоша или пурвахна). Эти данные берутся из заранее рассчитанной таблицы праздников, поэтому эндпоинт ограничен годами 2006-2046. Несколько записей сознательно не включены, чтобы не выдавать догадки за данные: среди них Agni Nakshatram, три даты Avani Avittam для отдельных Вед, Gayathri Japam и Agastya Arghya.
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. |
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. |
| year | integer | обязательный | Год рождения числом, например 1990. Четыре цифры. min 2006 · max 2046 |