Trang này có đủ ba bản. Mỗi bản là một địa chỉ riêng, gửi link cho người khác vẫn đúng ngôn ngữ.
Gợi ý hôm nay
Mã và dữ liệu mở
Nhật Nguyệt: mã và dữ liệu mở về Tử Vi, Bát Tự, Thần số học
Thư viện JavaScript, Python và dữ liệu mở để lập lá số, đổi âm lịch, xem giờ hoàng đạo, tra lễ hội và văn khấn. Dành cho người làm sản phẩm, nghiên cứu và trí tuệ nhân tạo.
3,6 triệulá số Tử Vi, Bát Tự, Thần số học luận sẵn
373văn bản sách cổ toàn văn, 72,7 triệu ký tự
2.669đoạn sách cổ trong ba bộ tri thức
510bài kiến thức
33bộ dữ liệu có DOI
456bài văn khấn
206lễ hội Việt Nam
4lịch âm: Việt Nam, Trung Quốc, Hàn Quốc, Nhật Bản
17.291ca kiểm đạt trọn
Luồng xây dựng: từ nguồn tới người dùng
Cơ sở khoa học nằm ở đâu?
Ở cách làm, không ở lời đoán.
Lịch là phép tính thiên văn: điểm sóc so với NASA, 24 tiết khí so với IMCCE (Đài thiên văn Paris), từ 1900 tới 2100.
Tất định, kiểm lại được: bản TypeScript và Python ra đúng từng trường của lõi tính gốc ở cả 17.291 ca kiểm.
Nêu chỗ các phái khác nhau và cho đổi: tháng nhuận, giờ Tý, Tứ Hóa can Canh, Hỏa Linh. Thư viện nói đang theo sách nào; anh chị chọn được quy tắc của sách khác, mỗi tuỳ chọn có ca kiểm riêng.
Có bài báo kỹ thuật về phép tính lịch: phương pháp, ngân sách sai số, đối chiếu NASA, IMCCE, JPL DE440, và lời giải thích cho từng ngày âm lịch Việt Nam khác Trung Quốc.
Mức chứng cứ: Tử Vi, Bát Tự, thần số học là quy tắc của từng phái, chưa được khoa học kiểm chứng.
Độ sâu: từ vị trí Mặt Trời, Mặt Trăng tới lời luậnSai số giờ giao tiết so với IMCCE trên 4.824 mốc, trước và sau 19/11/2026Nguồn số liệu: IMCCE (Đài Thiên văn Paris), 4.824 mốc giao tiết 1900 tới 2100, khoảng 2 phút. Từ 19/11/2026 giờ giao tiết tính theo lý thuyết VSOP87D: mọi mốc nay lệch IMCCE dưới một phút.
2.814 ngày trong 1900 tới 2100 có ngày âm khác nhau giữa giờ Việt Nam và giờ Bắc Kinh. Tết lệch ở 10 năm, rõ nhất 1985: Việt Nam đón Tết 21/1, Trung Quốc 20/2.
10 năm Tết lệch giữa giờ Việt Nam và giờ Bắc Kinh, 1900 tới 2100Tính bằng @nhatnguyet/lunar.
Thư viện cho chọn lịch của từng nước, mặc định lịch Việt Nam.
Lịch
Múi giờ
Dùng ở
Việt Nammặc định
UTC+7
Việt NamVN
Trung Quốc
UTC+8
Trung Quốc, Đài Loan, Hồng Kông, Ma Cao; Tết của người Hoa ở Singapore, Malaysia, Indonesia, PhilippinesCN, TW, HK, MO, SG, MY, ID, PH
Hàn Quốc
UTC+9
Hàn QuốcKR
Nhật Bản
UTC+9
Âm lịch cũ (kyūreki), dùng cho lễ truyền thốngJP
Mông Cổ, Tây Tạng, Thái Lan, Lào, Campuchia, Myanmar, Ấn Độ dùng hệ lịch khác quy tắc, chưa có trong thư viện.
Thần số học Pythagoras, tên tiếng Việt có dấu; vẽ SVG
@nhatnguyet/festivalstên Việt: @nhatnguyet/le-hoi
206 lễ hội Việt Nam kèm ngày từng năm, tỉnh, dân tộc, nơi tổ chức; xuất lịch iCalendar (.ics)
@nhatnguyet/cli
Dòng lệnh: lá số thành lưới, JSON, SVG hay tệp .ics; Python có cùng lệnh nhatnguyet
@nhatnguyet/mcp
Máy chủ MCP cho trợ lý AI, chạy trên máy
@nhatnguyet/widgets
5 thành phần web: lịch hôm nay, lịch tháng, giờ hoàng đạo, đếm ngược Tết, đổi lịch
nhatnguyet (PyPI)
Toàn bộ các phần trên trong một gói Python, ra đúng từng trường
Tuỳ chọn trường phái
Chỗ các sách an sao khác nhau, thư viện chọn một mặc định, nêu tên sách nó theo, và cho anh chị đổi bằng schools. Mặc định không bao giờ đổi; 432 ca kiểm riêng cho các tuỳ chọn. Đặt ba tuỳ chọn theo Toàn Thư thì so với iztro trên 610 lá số, chỗ lệch Hỏa Linh (484), Tứ Hóa can Canh (126) và Thiên Trù năm Quý (59) về 0.
nhatnguyet/sach-co: 373 văn bản cổ phạm vi công cộng, toàn văn, 72,7 triệu ký tự
nhatnguyet/classical-parallel: 1.328 cặp đoạn Kinh Dịch: chữ Hán với bản dịch tiếng Anh (952) và tiếng Pháp (376) phạm vi công cộng
terminology (trong repo): 416 thuật ngữ: tiếng Việt, chữ Hán phồn thể và giản thể, bính âm, tiếng Anh
ai-eval (trong repo): 1.520 câu hỏi có đáp án tính bằng máy (ngày âm, Tết, can chi, lá số), ba thứ tiếng, để đo mô hình ngôn ngữ
history (trong repo): Ngày Tết 1900 tới 2100 theo UTC+7 và UTC+8, kèm lịch Việt Nam thực dùng và nguồn
Cho AI và mẫu dự án
Máy chủ MCP (npx -y @nhatnguyet/mcp) cho trợ lý AI gọi phép tính thay vì đoán: đổi lịch, tiết khí, giờ hoàng đạo, lá số Tử Vi, Bát Tự, thần số học, lễ hội, vẽ SVG. Bốn mẫu dự án dùng ngay:
nextjs-lunar-calendar: Trang lịch âm Next.js: lịch tháng có ngày âm, tiết khí, đếm ngược Tết, lá số Tử Vi từ biểu mẫu
telegram-bot: Bot Telegram: /today, /tet, /ziwei, trả lời ba thứ tiếng
google-sheets: Hàm Google Sheets =LUNARDATE(), =SEXAGENARY(), =SOLARTERM(), =SOLARDATE() trong một tệp
jupyter: Sổ Jupyter: Tết, tháng nhuận Việt Nam và Trung Quốc 1900 tới 2100, có biểu đồ
Dữ liệu lấy từ đâu?
Sách cổ lời luận trích: Tử Vi Đẩu Số Toàn Thư, Trích Thiên Tủy, Cùng Thông Bảo Giám, Tam Mệnh Thông Hội, Uyên Hải Tử Bình, Hoàng Cực Kinh Thế... Nguyên văn đối chiếu bản in, mỗi câu ghi sách và chương. Đọc chuyên sâu
Lời luận của 3,6 triệu lá số: Nhật Nguyệt viết, ba thứ tiếng, cùng một khuôn. Đọc chuyên sâu
Toàn văn sách cổ: 373 văn bản phạm vi công cộng (khoảng 350 tác phẩm), 72,7 triệu ký tự, phần lớn là chữ Hán. Đọc chuyên sâu
510 bài kiến thức gắn với từng sao, cách cục, dụng thần, số chủ đạo.
Lễ hội: 206 lễ Việt Nam, ngày âm quy đổi sang dương từng năm bằng chính thư viện lịch. Đọc chuyên sâu
Văn cúng: 456 bài, 155 loại lễ. Văn sưu tầm trong dân gian; Nhật Nguyệt biên tập, phân loại, không nhận là tác giả lời văn. Đọc chuyên sâu
Không có sách còn bản quyền.
Dùng để làm gì?
Độ rộng: các lĩnh vực đã phủ
Xây sản phẩm
Ứng dụng, website, app lịch: lá số, đổi âm dương, giờ hoàng đạo, lễ hội chạy ngay trên máy người dùng.
Lá số này có Mệnh ở Hợi, Thổ Ngũ Cục, bốn cách cục được nhận ra.
Kết quả
chart.bureau.name // "Thổ Ngũ Cục"
chart.palaces[chart.lifePalace].branch // "Hợi"
chart.palaces[chart.lifePalace].stars[0] // Thái Âm (Miếu, Hóa Kỵ)
patterns.map((p) => p.name)
// "Cơ Nguyệt Đồng Lương", "Tả Hữu đồng hội", "Nhật xuất Phù Tang", "Nguyệt lạc Hợi cung"
Cơ Nguyệt Đồng Lương
Tả Hữu đồng hội
Nhật xuất Phù Tang
Nguyệt lạc Hợi cung
Dùng lại và ghi nguồn thế nào?
Mã nguồn: MIT. Giữ dòng bản quyền Copyright (c) 2026 Nhat Nguyet (nhatnguyet.org) trong mọi bản sao.
Dữ liệu và lời luận: CC BY 4.0. Được dùng cho cả mục đích thương mại, được sửa, với điều kiện ghi nguồn.
Câu ghi nguồn chuẩn: Dữ liệu: Nhật Nguyệt (nhatnguyet.org). Ứng dụng hiện kết quả thì ghi "Theo Nhật Nguyệt" ở chỗ người dùng thấy; nghiên cứu thì trích theo DOI.
Tên và dấu Nhật Nguyệt là thương hiệu, không nằm trong giấy phép: không đặt tên hay trình bày khiến người dùng hiểu là sản phẩm của Nhật Nguyệt.
Riêng tư: thư viện tính ngay trên máy, không gửi dữ liệu đi đâu.
Trích dẫn
Nghiên cứu dùng thư viện thì trích theo DOI của thư viện; dùng bộ dữ liệu thì trích DOI của bộ dữ liệu. Hai DOI khái niệm luôn trỏ bản mới nhất.
Nhat Nguyet (2026). Nhat Nguyet: open source code and data for Zi Wei Dou Shu, BaZi and numerology. Zenodo. https://doi.org/10.5281/zenodo.24358013
BibTeX
@software{nhatnguyet_2026,
author = {{Nhat Nguyet}},
title = {Nhat Nguyet: open source code and data for Zi Wei Dou Shu, BaZi and numerology},
year = {2026},
url = {https://nhatnguyet.org/en/ma-nguon-mo},
doi = {10.5281/zenodo.24358013}
}
Hỏi đáp
Lá số Tử Vi của thư viện có những gì?
Đủ một lá số: cục, cung Mệnh, cung Thân, 14 chính tinh và phụ tinh, sáng tối, Tứ Hóa, Tuần Triệt, đại vận, hạn năm, sao lưu. Cách cục gồm cả các cách của Tử Vi Đẩu Số Toàn Thư.
Có những gói nào?
Năm gói npm tính toán và một gói Python. npm: @nhatnguyet/lunar, ziwei, bazi, numerology, festivals (cùng mã với các gói tên Việt am-lich, tu-vi, bat-tu, than-so-hoc, le-hoi), thêm cli, mcp, widgets. Python: pip install nhatnguyet gồm cả năm phần.
Dùng dữ liệu này huấn luyện AI thương mại được không?
Được, theo giấy phép CC BY 4.0. Điều kiện duy nhất là ghi nguồn "Dữ liệu: Nhật Nguyệt (nhatnguyet.org)".
Bát Tự lấy trụ tháng theo tháng âm hay theo tiết khí?
Theo tiết khí, đúng phép Tứ Trụ: trụ năm đổi ở Lập Xuân, trụ tháng đổi ở ngày giao tiết, không theo mùng 1 âm lịch.
Người sinh giờ Tý (23h tới 0h) thì tính ngày nào?
Hai môn hai cách, cả hai được giữ: Bát Tự đổi ngày từ 23h, Tử Vi lấy đúng ngày đã nhập. Vì thế hai lá số có thể ra hai ngày khác nhau; lá số Tử Vi mang dòng ghi chú về giờ Tý.
Thần số học tính tên tiếng Việt có dấu thế nào?
Bỏ dấu rồi tính theo bảng Pythagoras, "Đ" tính là "D". Có đủ số chủ đạo, sứ mệnh, linh hồn, nhân cách, thái độ, đỉnh cao, thử thách, năm, tháng, ngày cá nhân.