Panchang (almanach Vệ Đà)

Panchang (पञ्चाङ्ग, “năm thành phần”) là một almanac Vệ-đà cho ngày cụ thể và vị trí địa lý. Năm thành phần chính (tithi, vara, nakshatra, yoga, karana) xác định tính thuận lợi của thời gian cho các hành động - từ đám cưới đến ra mắt sản phẩm. AstroWay bao phủ tất cả năm thành phần cộng với các khung thời gian bổ sung (choghadia, hora, rahu-kaal) bằng một API.

Những gì chúng ta tính

Tithi (ngày mặt trăng): 30 tithi trong chu kỳ đồng trăng, mỗi tithi có chênh lệch 12° giữa Mặt Trăng và Mặt Trời. Đây là chỉ số quan trọng cho hầu hết các muhurta.
Karana (nửa tithi): 11 karana, mỗi cái có độ dài 6°. Chúng phân loại hoạt động của ngày.
Yoga (kết hợp): 27 yoga, tổng độ dài của Mặt Trời và Mặt Trăng, chia cho 13°20’. Đây là đặc tính năng lượng của ngày.
Nakshatra-of-day: vị trí sao chính cho ngày (kèm dấu chuyển đổi nếu trong ngày có hơn một).
Choghadia: 8 khung ngày + 8 khung đêm, mỗi khung 1.5 giờ, với các nhãn “Amrit / Shubh / Labh / Char” (thuận) và “Kaal / Rog / Udveg” (không thuận).
Hora: giờ hành tinh (phiên bản Vệ-đà, tính từ lúc mặt trời mọc, 24 hora khoảng ~1 giờ mỗi).
Rahu Kaal: khoảng thời gian không thuận (1/8 ngày ánh sáng, phụ thuộc vào ngày trong tuần).
Full panchang: tất cả các mục trên trong một yêu cầu (tiện lợi cho widget hàng ngày).

Các endpoint

Endpoint	Credits	Trả về
`/v1/vedic/panchang/tithi`	20	Tithi hiện tại + thời điểm chuyển sang tithi tiếp theo
`/v1/vedic/panchang/karana`	20	Karana hiện tại + chuyển đổi
`/v1/vedic/panchang/yoga`	20	Yoga hiện tại + chuyển đổi
`/v1/vedic/panchang/nakshatra-of-day`	20	Nakshatra của ngày + pada + chuyển đổi
`/v1/vedic/panchang/choghadia`	20	16 khung (8 ngày + 8 đêm) với các nhãn
`/v1/vedic/panchang/hora`	20	24 giờ hành tinh
`/v1/vedic/panchang/rahu-kaal`	20	Khoảng thời gian Rahu/Yama/Gulika Kaal
`/v1/vedic/panchang/full`	20	Tất cả các mục trên trong một phản hồi

Ví dụ

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']}")

Ví dụ phản hồi

{
  "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" }
}

Độ chính xác và nguồn

Văn bản chuẩn: Surya Siddhanta (cho tithi/karana/yoga), Brihat Samhita (cho choghadia/muhurta), Phaladipika (cho hora). Các tính toán Mặt Trăng thực tế dựa trên Swiss Ephemeris (DE441/440), không phải trung bình - điều này quan trọng đối với chuyển đổi tithi (sự chênh lệch có thể lên tới 3 giờ).
Reference cross-check: drikpanchang.com - nguồn công khai lớn nhất của panchang. Các chuyển đổi tithi/nakshatra của chúng tôi khớp với drikpanchang trong phạm vi ±30 giây cho Lahiri ayanamsa.
Choghadia: chúng tôi sử dụng thứ tự cổ điển của 7 vị hành tinh làm người quản trị. Khung đầu tiên của ngày = người quản trị của ngày trong tuần (chủ nhật - Mặt Trời, v.v.).
Rahu Kaal: các khoảng thời gian cố định 1/8 từ mặt trời mọc đến mặt trời lặn, bản đồ ngày trong tuần → số khung theo truyền thống (thứ Hai = khung 2, thứ Ba = khung 7, v.v.).
Vị trí quan sát quan trọng. Nakshatra và tithi thay đổi cùng một lúc theo UTC ở mọi nơi - nhưng ngày hiển thị phụ thuộc vào múi giờ. Gửi timezoneOffset của đúng địa điểm mà người dùng muốn đọc panchang.

Liên quan

Dashi: khoảng thời gian dài hạn (năm/thập kỷ), panchang - ngắn hạn (ngày)
Shadbala: sức mạnh của các hành tinh tại thời điểm panchang
Vargas: biểu đồ phân chia để phân tích sâu hơn về murti
Độ chính xác: kiểm thử snapshot panchang so với drikpanchang
Credits: bảng giá đầy đủ
Xác thực: cách lấy khóa aw_live_*

Hữu ích chứ?

Đề xuất chỉnh sửa

Cập nhật lần cuối: 29 thg 9, 2026