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 तक काम करता है। कुछ प्रविष्टियाँ अंदाज़ा लगाने के बजाय जानबूझकर छोड़ी गई हैं, जैसे अग्नि नक्षत्रम, तीनों वेदों की अलग-अलग आवणी अवित्तम तारीख़ें, गायत्री जपम और अगस्त्य अर्घ्य।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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 |