Lịch âm Việt Nam API

Đổi ngày dương ⇄ âm lịch Việt Nam có tháng nhuận, Can Chi, con giáp, tiết khí, giờ hoàng đạo và ngày lễ âm lịch như Tết. Hỗ trợ năm 1800–2199.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "solar": {
    "date": "2026-02-17",
    "weekday": "Tuesday",
    "weekday_vi": "Thứ Ba"
  },
  "lunar": {
    "day": 1,
    "month": 1,
    "year": 2026,
    "leap": false,
    "text": "01/01/2026",
    "month_length": 30,
    "month_start": "2026-02-17",
    "leap_month_of_year": null
  },
  "can_chi_day": "Nhâm Tuất",
  "holiday": {
    "vi": "Tết Nguyên Đán",
    "en": "Lunar New Year (Tết)"
  },
  "can_chi": {
    "year": "Bính Ngọ",
    "month": "Canh Dần",
    "day": "Nhâm Tuất",
    "first_hour": "Canh Tý"
  },
  "zodiac": {
    "vi": "Ngựa",
    "en": "Horse"
  },
  "solar_term": {
    "vi": "Lập xuân",
    "en": "Start of Spring"
  },
  "lucky_hours": [
    {
      "chi": "Dần",
      "from": "03:00",
      "to": "05:00"
    },
    {
      "chi": "Thìn",
      "from": "07:00",
      "to": "09:00"
    },
    {
      "chi": "Tỵ",
      "from": "09:00",
      "to": "11:00"
    },
    {
      "chi": "Thân",
      "from": "15:00",
      "to": "17:00"
    },
    {
      "chi": "Dậu",
      "from": "17:00",
      "to": "19:00"
    },
    {
      "chi": "Hợi",
      "from": "21:00",
      "to": "23:00"
    }
  ],
  "julian_day": 2461089,
  "first_or_full_moon": "mùng 1"
}

Ứng dụng

• Hiện ngày âm bên cạnh ngày dương trong ứng dụng lịch, đặt lịch
• Nhắc ngày giỗ, ngày lễ âm lịch hằng năm
• Lên kế hoạch chiến dịch Tết, Trung thu cho thương mại điện tử
• In lịch tháng có ngày âm và ngày lễ

Hỏi đáp

API liên quan