@minhbc97/lunar

@minhbc97/lunar

Wrapper âm lịch Việt Nam cho Lịch An Gia.

Bọc @baostudio/viet-lunar với API ổn định, type chuẩn hóa, ngày lễ và bộ test ngày mốc.

Cài đặt

npm install @minhbc97/lunar

Yêu cầu Node.js ≥ 18. Package ESM (import).

API chính

import {
  convertSolarToLunar,
  convertLunarToSolar,
  getDayAlmanac,
  getTodayAlmanac,
  buildMonthGrid,
  getSolarToday,
} from "@minhbc97/lunar";

const lunar = convertSolarToLunar({ year: 2025, month: 1, day: 29 });
// { year: 2025, month: 1, day: 1, isLeapMonth: false }

const almanac = getDayAlmanac({ year: 2025, month: 6, day: 29 });
// canChi, hoangDao, nen, kieng, holidays, ...

const grid = buildMonthGrid(2025, 6);
// ô lịch tháng dương + âm

Quy ước

• SolarDate / LunarDate: tháng 1–12.
• LunarDate.isLeapMonth: tháng nhuận âm lịch VN.
• Timezone mặc định: Asia/Ho_Chi_Minh.

Ứng dụng và API server không import @baostudio/viet-lunar trực tiếp — chỉ qua package này.

Phát triển

Clone repo, cài dependency, chạy test và build:

npm install
npm test
npm run build

Hướng dẫn publish và CI dành cho maintainer: PUBLISHING.md.

License

MIT