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}'O calendário tâmil é solar, e não lunar, e é isso que o distingue da maioria dos outros calendários regionais desta API. Um mês começa no momento em que o Sol entra em um novo signo sideral, então os doze meses (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi e Panguni) acompanham a posição do Sol e começam aproximadamente nas mesmas datas gregorianas todo ano, com Chithirai abrindo o ano por volta de 14 de abril. O primeiro dia do mês segue a regra do pôr do sol: se o ingresso do Sol ocorre entre o nascer e o pôr do sol, esse dia civil é o primeiro dia; se ocorre depois do pôr do sol, o primeiro dia é o seguinte. Os calendários telugu, marathi, gujarati e kannada, por outro lado, contam os meses a partir de uma lua nova ou cheia. Envie um `year` junto com `latitude`, `longitude` e `timezone_as_float`. O nascer e o pôr do sol que determinam cada observância são calculados para essas coordenadas, então um evento pode se deslocar em um dia se você mudar de local. A resposta é `{year, events}`, em que cada evento é `{name, date, tamil_month, tamil_day}` — a data gregoriana mais a posição dentro do mês tâmil —, abrangendo o ano gregoriano inteiro. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai e os demais aparecem com seus nomes em tâmil. Vários desses festivais correspondem ao mesmo tithi lunar que o motor principal de festivais hindus calcula, consultado pelo nome tâmil e depois resolvido pela regra de observância própria de cada um (nascer do sol, madhyahna, aparahna, nishita, pradosha ou purvahna). Esses vêm da tabela de festivais pré-calculada e, por isso, limitam este endpoint aos anos 2006-2046. Algumas entradas foram deliberadamente deixadas de fora, em vez de adivinhadas, entre elas Agni Nakshatram, as três datas de Avani Avittam específicas de cada Veda, Gayathri Japam e Agastya Arghya.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. |
| timezone_as_float | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 2006 · max 2046 |