Vietnamese Lunar Calendar Converter
Convert solar ⇄ Vietnamese lunar dates (âm lịch) with leap months, Can Chi, zodiac, solar terms, lucky hours and lunar holidays such as Tết. Years 1800–2199.
Result
Press “Run” to see the result.
The Lunar Calendar API converts between the Gregorian calendar and the Vietnamese lunar calendar, computed for Vietnam’s timezone (UTC+7) with the astronomical algorithm of Hồ Ngọc Đức. This matters: in some years Tết falls one day earlier or a month differently than in China, so Chinese lunar libraries give wrong Vietnamese dates.
?date=2026-02-17 (default: today in Vietnam) returns the lunar day, month and year, whether the month is a leap month, the length of the lunar month, the leap month of that year, Can Chi of the year, month, day and first hour, the zodiac animal, the solar term (tiết khí), the six lucky hours (giờ hoàng đạo) and the lunar holiday of the day (Tết, Rằm tháng Giêng, Giỗ Tổ Hùng Vương, Vu Lan, Trung thu, Ông Công Ông Táo, Giao thừa…).
?lunar=2026-08-15 converts a lunar date to the solar date (add leap=true for a day of the leap month; impossible dates such as a missing 30th or a non-existent leap month return a clear error). ?month=2026-11 returns every day of a solar month with its lunar date for building calendars.
Use this in your code
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));API documentation → Get a free API key
FAQ
When is Tết 2026?
17 February 2026 (Bính Ngọ year). Call /v1/lunar-calendar?lunar=2026-01-01 to get it for any year.
How do I find a yearly death anniversary?
Keep the lunar date of the anniversary, and every year call ?lunar=YYYY-MM-DD with the new year. If the original day was the 30th and the month has only 29 days that year, the API returns an error so you can choose the 29th.
Which years are supported?
1800 to 2199. The algorithm uses astronomical new moon and solar term calculations, accurate for that range.