पंचांग (वैदिक कैलेंडर)

पंचांग (पञ्चाङ्ग, “पाँच अंग”) किसी ख़ास दिन और भौगोलिक स्थान के लिए वैदिक कैलेंडर है। इसके पाँच मुख्य अंग (tithi, vara, nakshatra, yoga, karana) तय करते हैं कि कोई काम शुरू करने के लिए समय कितना शुभ है, विवाह से लेकर प्रोडक्ट लॉन्च तक। AstroWay एक ही API में पाँचों अंग और अतिरिक्त समय-खंड (choghadia, hora, rahu-kaal) देता है।

हम क्या गणना करते हैं

Tithi (चंद्र दिवस): सिनोडिक चक्र में 30 tithi, हर एक चंद्रमा और सूर्य के बीच 12° का अंतर। ज़्यादातर मुहूर्तों के लिए मुख्य संकेतक।
Karana (आधी तिथि): 11 karana, हर एक 6° देशांतर। दिन की गतिविधि का वर्गीकरण करते हैं।
Yoga (योग): 27 yoga, सूर्य और चंद्रमा के देशांतर का योग 13°20’ से भाग देकर। दिन की ऊर्जा का स्वरूप।
Nakshatra-of-day: तारीख़ का मुख्य नक्षत्र (अगर दिन में एक से ज़्यादा नक्षत्र हों तो बदलाव के समय के साथ)।
Choghadia: दिन के 8 और रात के 8 स्लॉट, हर एक लगभग 1.5 घंटे का, “Amrit / Shubh / Labh / Char” (शुभ) और “Kaal / Rog / Udveg” (अशुभ) लेबल के साथ।
Hora: ग्रहों के घंटे (वैदिक पद्धति, सूर्योदय से, लगभग 1 घंटे के 24 hora)।
Rahu Kaal: अशुभ अवधि (दिन के उजाले का 1/8 हिस्सा, सप्ताह के दिन पर निर्भर)।
Full panchang: ऊपर का सब कुछ एक ही अनुरोध में (daily widget के लिए सुविधाजनक)।

Endpoints

Endpoint	क्रेडिट	क्या लौटाता है
`/v1/vedic/panchang/tithi`	20	वर्तमान tithi + अगली tithi में बदलाव का क्षण
`/v1/vedic/panchang/karana`	20	वर्तमान karana + बदलाव
`/v1/vedic/panchang/yoga`	20	वर्तमान yoga + बदलाव
`/v1/vedic/panchang/nakshatra-of-day`	20	दिन का नक्षत्र + pada + बदलाव
`/v1/vedic/panchang/choghadia`	20	लेबल सहित 16 स्लॉट (8 day + 8 night)
`/v1/vedic/panchang/hora`	20	ग्रहों के 24 घंटे
`/v1/vedic/panchang/rahu-kaal`	20	Rahu/Yama/Gulika Kaal की अवधियाँ
`/v1/vedic/panchang/full`	20	ऊपर का सब कुछ एक ही जवाब में

उदाहरण

curl -X POST https://api.astroway.info/v1/vedic/panchang/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-11",
    "time": "06:00:00",
    "timezoneOffset": 5.5,
    "latitude": 28.6139,
    "longitude": 77.2090,
    "ayanamsa": "lahiri"
  }'

const r = await fetch('https://api.astroway.info/v1/vedic/panchang/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '2026-05-11',
    time: '06:00:00',
    timezoneOffset: 5.5,
    latitude: 28.6139,
    longitude: 77.2090,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
console.log(`Tithi: ${data.tithi.name}, Nakshatra: ${data.nakshatra.name}`);
console.log(`Rahu Kaal: ${data.rahuKaal.startTime} - ${data.rahuKaal.endTime}`);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/panchang/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '2026-05-11', 'time': '06:00:00', 'timezoneOffset': 5.5,
        'latitude': 28.6139, 'longitude': 77.2090,
        'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
print(f"Tithi: {data['tithi']['name']}, Nakshatra: {data['nakshatra']['name']}")

जवाब का उदाहरण

{
  "jd": 2461171.520833,
  "ayanamsa": 24.225277,
  "sunrise": "05:33:04",
  "sunset": "19:02:21",
  "tithi": {
    "number": 24,
    "name": "Navami",
    "paksha": "krishna",
    "indexInPaksha": 9,
    "elongation": 283.301369,
    "percentComplete": 0.608447
  },
  "vara": { "number": 1, "name": "Somavara", "ruler": "Moon" },
  "karana": { "index": 48, "name": "Garaja", "isFixed": false },
  "yoga": { "number": 2, "name": "Priti", "sumLongitude": 23.999794 },
  "nakshatra": {
    "number": 24,
    "name": "Shatabhisha",
    "ruler": "Rahu",
    "startDeg": 306.6667,
    "endDeg": 320,
    "pada": 1,
    "longitude": 309.423644
  },
  "rahuKaal": { "name": "Rahu Kaal", "weekdaySlot": 2, "startHour": 7.237123, "endHour": 8.923138, "startTime": "07:14:14", "endTime": "08:55:23" },
  "yamaganda": { "name": "Yamaganda", "weekdaySlot": 4, "startHour": 10.609153, "endHour": 12.295168, "startTime": "10:36:33", "endTime": "12:17:43" },
  "gulika": { "name": "Gulika", "weekdaySlot": 6, "startHour": 13.981183, "endHour": 15.667198, "startTime": "13:58:52", "endTime": "15:40:02" },
  "abhijitMuhurat": { "startHour": 11.845564, "endHour": 12.744772, "midHour": 12.295168, "muhurtaMinutes": 53.952481, "startTime": "11:50:44", "endTime": "12:44:41" }
}

सटीकता और स्रोत

मूल ग्रंथ: Surya Siddhanta (tithi/karana/yoga के लिए), Brihat Samhita (choghadia/muhurta के लिए), Phaladipika (hora के लिए)। गणना Swiss Ephemeris (DE441/440) के अनुसार वास्तविक चंद्रमा से होती है, औसत चंद्रमा से नहीं। tithi के बदलाव के लिए यह बहुत अहम है (अंतर 3 घंटे तक हो सकता है)।
Reference cross-check: drikpanchang.com पंचांग का सबसे बड़ा सार्वजनिक स्रोत है। Lahiri ayanamsa के लिए हमारे tithi/nakshatra बदलाव drikpanchang से ±30 सेकंड के भीतर मेल खाते हैं।
Choghadia: हम 7 ग्रह-स्वामियों का शास्त्रीय क्रम इस्तेमाल करते हैं। दिन का पहला स्लॉट = सप्ताह के दिन का स्वामी (रविवार - सूर्य, आदि)।
Rahu Kaal: सूर्योदय से सूर्यास्त तक तय 1/8 अवधियाँ, सप्ताह के दिन से स्लॉट नंबर का शास्त्रीय मिलान (सोमवार = दूसरा, मंगलवार = सातवाँ, आदि)।
अवलोकन का स्थान मायने रखता है। नक्षत्र और tithi हर जगह UTC के एक ही क्षण में बदलते हैं, लेकिन दिखने वाली तारीख़ें समय क्षेत्र पर निर्भर करती हैं। timezoneOffset ठीक उसी जगह का भेजें, जहाँ का पंचांग उपयोगकर्ता पढ़ना चाहता है।