Skip to content
This repository was archived by the owner on Feb 5, 2026. It is now read-only.

Releases: mnoyd/amlich-view

Version 2.0.0 - Solar Terms & Auspicious Hours

05 Feb 09:10

Choose a tag to compare

Vietnamese Lunar Calendar Expert Engine v2.0.0

🎉 Phase 2 Complete - Solar Terms & Auspicious Hours

This release includes comprehensive Vietnamese almanac features with astronomical precision.

✨ New Features

24 Solar Terms (Tiết khí)

  • Astronomical calculation based on sun's ecliptic longitude
  • All 24 terms with Vietnamese names
  • Season classification (Xuân, Hạ, Thu, Đông)
  • Equinoxes & solstices verification
  • Current sun longitude display

Auspicious Hours (Giờ Hoàng Đạo)

  • Traditional 12-Star System (Thập Nhị Kiến Trừ)
  • 6 Good Stars: Thanh Long, Minh Đường, Kim Quỹ, Bảo Quang, Ngọc Đường, Tư Mệnh
  • 6 Bad Stars: Thiên Hình, Chu Tước, Bạch Hổ, Thiên Lao, Nguyên Vũ, Câu Trận
  • Hour-by-hour analysis with time ranges

📊 Complete Features

✅ Solar ↔ Lunar conversion (accurate 1900-2199)
✅ Can Chi (干支) - Day/Month/Year
✅ Con Giáp - Vietnamese Zodiac (12 animals)
✅ Ngũ Hành - Five Elements
✅ 24 Solar Terms (Tiết khí) ⭐ NEW
✅ Auspicious Hours (Giờ hoàng đạo) ⭐ NEW
✅ Vietnamese holidays
✅ Calendar export (ICS/CSV)

📈 Statistics

  • Code: 805 lines of expert almanac logic
  • Tests: 100% passing (6 reference dates)
  • Dependencies: 0 (Pure Node.js!)

🚀 Quick Start

git clone https://github.com/mnoyd/amlich-view.git
cd amlich-view
node index.js today

📚 Documentation

  • README.md - Complete user guide
  • PHASE2-COMPLETE.md - Phase 2 details
  • API documentation included

Made with ❤️ for Vietnamese culture and traditions