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}'Тамільський календар сонячний, а не місячний, і саме цим він відрізняється від більшості інших регіональних календарів у цьому API. Місяць починається в момент входу Сонця в новий сидеричний знак, тож дванадцять місяців (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 та інші свята подано під тамільськими назвами. Деякі з цих свят припадають на ту саму місячну тітхі, яку обчислює основне ядро індуських свят: її шукають під тамільською назвою, а потім визначають за власним правилом обряду (sunrise, madhyahna, aparahna, nishita, pradosha або purvahna). Такі свята беруться з попередньо обчисленої таблиці, тож ендпоінт працює лише для років 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 |