/api/astro/tamil_calendar/1 क्रेडिटतमिल कैलेंडर
तमिल कैलेंडर चांद्र नहीं, सौर है, और यही इसे यहाँ के ज़्यादातर क्षेत्रीय कैलेंडरों से अलग करता है। महीना उस क्षण शुरू होता है जब सूर्य नई निरयन राशि में प्रवेश करता है, इसलिए बारह महीने (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 तक काम करता है। कुछ प्रविष्टियाँ अंदाज़ा लगाने के बजाय जानबूझकर छोड़ी गई हैं, जैसे अग्नि नक्षत्रम, तीनों वेदों की अलग-अलग आवणी अवित्तम तारीख़ें, गायत्री जपम और अगस्त्य अर्घ्य।
https://api.occultapi.com/api/astro/tamil_calendar/
ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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 |
उदाहरण अनुरोध
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}'उत्तर
{
"data": {
"year": 2026,
"events": [
{
"name": "Arudra Darshan",
"date": "2026-01-03",
"tamil_month": "Margazhi",
"tamil_day": 19
},
{
"name": "Bhogi Pandigai",
"date": "2026-01-13",
"tamil_month": "Margazhi",
"tamil_day": 29
},
{
"name": "Pongal",
"date": "2026-01-14",
"tamil_month": "Thai",
"tamil_day": 1
},
{
"name": "Mattu Pongal",
"date": "2026-01-15",
"tamil_month": "Thai",
"tamil_day": 2
},
{
"name": "Thai Amavasai",
"date": "2026-01-18",
"tamil_month": "Thai",
"tamil_day": 5
},
{
"name": "Ratha Sapthami",
"date": "2026-01-25",
"tamil_month": "Thai",
"tamil_day": 12
},
{
"name": "Thai Pusam",
"date": "2026-02-01",
"tamil_month": "Thai",
"tamil_day": 19
},
{
"name": "Shivaratri",
"date": "2026-02-15",
"tamil_month": "Maasi",
"tamil_day": 3
},
{
"name": "Masi Magam",
"date": "2026-03-03",
"tamil_month": "Maasi",
"tamil_day": 19
},
{
"name": "Karadaiyan Nombu",
"date": "2026-03-14",
"tamil_month": "Maasi",
"tamil_day": 30
},
{
"name": "Ugadi - Telugu New Year",
"date": "2026-03-19",
"tamil_month": "Panguni",
"tamil_day": 5
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26",
"tamil_month": "Panguni",
"tamil_day": 12
},
{
"name": "Panguni Uthiram",
"date": "2026-04-01",
"tamil_month": "Panguni",
"tamil_day": 18
},
{
"name": "Puthandu",
"date": "2026-04-14",
"tamil_month": "Chithirai",
"tamil_day": 1
},
{
"name": "Vishu",
"date": "2026-04-15",
"tamil_month": "Chithirai",
"tamil_day": 2
},
{
"name": "Akshaya Thiruthiyai",
"date": "2026-04-19",
"tamil_month": "Chithirai",
"tamil_day": 6
},
{
"name": "Sankara Jayanthi",
"date": "2026-04-21",
"tamil_month": "Chithirai",
"tamil_day": 8
},
{
"name": "Ramanuja Jayanthi",
"date": "2026-04-22",
"tamil_month": "Chithirai",
"tamil_day": 9
},
{
"name": "Chitra Pournami",
"date": "2026-05-01",
"tamil_month": "Chithirai",
"tamil_day": 18
},
{
"name": "Vaikasi Visakam",
"date": "2026-05-30",
"tamil_month": "Vaikasi",
"tamil_day": 16
},
{
"name": "Aadi Perukku",
"date": "2026-08-03",
"tamil_month": "Aadi",
"tamil_day": 18
},
{
"name": "Aadi Amavasai",
"date": "2026-08-12",
"tamil_month": "Aadi",
"tamil_day": 27
},
{
"name": "Andal Jayanthi",
"date": "2026-08-14",
"tamil_month": "Aadi",
"tamil_day": 29
},
{
"name": "Gokulastami",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Astami Rohini",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Vinayagar Chathurthi",
"date": "2026-09-14",
"tamil_month": "Aavani",
"tamil_day": 29
},
{
"name": "Mahalaya Amavasai",
"date": "2026-10-10",
"tamil_month": "Purattasi",
"tamil_day": 24
},
{
"name": "Navarathiri",
"date": "2026-10-11",
"tamil_month": "Purattasi",
"tamil_day": 25
},
{
"name": "Ayutha Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Saraswati Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vijaya Dashami",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vidyarambham",
"date": "2026-10-21",
"tamil_month": "Aippasi",
"tamil_day": 4
},
{
"name": "Lakshmi Puja",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Kedara Gowri Vratham",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Deepavali",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24",
"tamil_month": "Karthigai",
"tamil_day": 8
},
{
"name": "Subrahmanya Sashti",
"date": "2026-12-15",
"tamil_month": "Karthigai",
"tamil_day": 29
},
{
"name": "Vaikuntha Ekadashi",
"date": "2026-12-20",
"tamil_month": "Margazhi",
"tamil_day": 5
},
{
"name": "Arudra Darshan",
"date": "2026-12-24",
"tamil_month": "Margazhi",
"tamil_day": 9
}
]
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।