Tới nội dung

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ùngNguồn: NASA, IMCCE số liệu thiên văn; 373 văn bản sách cổ; 510 bài kiến thức; 206 lễ hội; 456 bài văn khấn. Tính: 4 lịch âm các nước; 24 tiết khí, can chi; Tử Vi, Bát Tự an sao, bốn trụ; Thần số học tên tiếng Việt; 2.669 đoạn sách cổ, ba bộ tri thức. Kiểm: 17.291 ca kiểm đạt trọn; 0,9 phút điểm sóc trễ NASA, trung bình; 0,27 phút giờ giao tiết lệch IMCCE; SHA-256, DOI mã băm cho từng tệp. Phát hành: npm, PyPI 13 gói npm, 1 gói Python; GitHub mã nguồn MIT; 33 bộ dữ liệu, DOI Zenodo; 3,6 triệu lá số, Hugging Face. Dùng: Ứng dụng lịch, lá số, nhắc ngày; Website tiện ích tra cứu; AI huấn luyện, trích dẫn; Nghiên cứu thống kê, so lịch1. NguồnNASA, IMCCEsố liệu thiên văn373văn bản sách cổ510bài kiến thức206lễ hội456bài văn khấn2. Tính4lịch âm các nước24tiết khí, can chiTử Vi, Bát Tựan sao, bốn trụThần số họctên tiếng Việt2.669đoạn sách cổ, ba bộ trithức3. Kiểm17.291ca kiểm đạt trọn0,9 phútđiểm sóc trễ NASA,trung bình0,27 phútgiờ giao tiết lệchIMCCESHA-256, DOImã băm cho từng tệp4. Phát hànhnpm, PyPI13 gói npm, 1 góiPythonGitHubmã nguồn MIT33bộ dữ liệu, DOIZenodo3,6 triệulá số, Hugging Face5. DùngỨng dụnglịch, lá số, nhắc ngàyWebsitetiện ích tra cứuAIhuấn luyện, trích dẫnNghiên cứuthống kê, so lịchLuồng xây dựng: từ nguồn tới người dùngNguồn: NASA, IMCCE số liệu thiên văn; 373 văn bản sách cổ; 510 bài kiến thức; 206 lễ hội; 456 bài văn khấn. Tính: 4 lịch âm các nước; 24 tiết khí, can chi; Tử Vi, Bát Tự an sao, bốn trụ; Thần số học tên tiếng Việt; 2.669 đoạn sách cổ, ba bộ tri thức. Kiểm: 17.291 ca kiểm đạt trọn; 0,9 phút điểm sóc trễ NASA, trung bình; 0,27 phút giờ giao tiết lệch IMCCE; SHA-256, DOI mã băm cho từng tệp. Phát hành: npm, PyPI 13 gói npm, 1 gói Python; GitHub mã nguồn MIT; 33 bộ dữ liệu, DOI Zenodo; 3,6 triệu lá số, Hugging Face. Dùng: Ứng dụng lịch, lá số, nhắc ngày; Website tiện ích tra cứu; AI huấn luyện, trích dẫn; Nghiên cứu thống kê, so lịch1. NguồnNASA, IMCCEsố liệu thiên văn373văn bản sách cổ510bài kiến thức206lễ hội456bài văn khấn2. Tính4lịch âm các nước24tiết khí, can chiTử Vi, Bát Tựan sao, bốn trụThần số họctên tiếng Việt2.669đoạn sách cổ, ba bộ tri thức3. Kiểm17.291ca kiểm đạt trọn0,9 phútđiểm sóc trễ NASA, trungbình0,27 phútgiờ giao tiết lệch IMCCESHA-256, DOImã băm cho từng tệp4. Phát hànhnpm, PyPI13 gói npm, 1 gói PythonGitHubmã nguồn MIT33bộ dữ liệu, DOI Zenodo3,6 triệulá số, Hugging Face5. DùngỨng dụnglịch, lá số, nhắc ngàyWebsitetiện ích tra cứuAIhuấn luyện, trích dẫnNghiên cứuthống kê, so lịch
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ậnTử Vi: 1. Mặt Trời, Mặt Trăng (vị trí thật trên trời): điểm sóc trễ NASA trung bình 0,9 phút; 2. Lịch âm (theo giờ Việt Nam, UTC+7): 14.936 ca kiểm lịch; 3. Can chi (năm, tháng, ngày, giờ): 73.414 ngày, 1900 tới 2100; 4. Lá số (cục, cung Mệnh, Thân, 14 chính tinh, phụ tinh, sáng tối, Tứ Hóa, Tuần Triệt): 777 lá số khớp từng trường; 5. Đại vận, hạn năm (sao lưu theo năm xem): 12 đại vận, mỗi vận 10 năm; 6. Cách cục (theo Tử Vi Đẩu Số Toàn Thư): 24 cách dựng được, 6 cách không thể xảy ra; 7. Câu sách cổ (khớp đúng lá số): 885 đoạn trong bộ ziwei-knowledge; 8. Lời luận (13 phần, ba thứ tiếng): 3,6 triệu lá số luận sẵn. Bát Tự: 1. Tiết khí tới phút: lệch IMCCE 0,27 phút; 2. Bốn trụ: năm đổi ở Lập Xuân, tháng ở giờ giao tiết; 3. Tàng can, thập thần: 777 lá số khớp từng trường; 4. Đại vận: mỗi vận 10 năm; 5. Câu sách cổ: từ 7 sách cổ.Tử Vi1Mặt Trời, Mặt Trăngvị trí thật trên trờiđiểm sóc trễ NASA trungbình 0,9 phút2Lịch âmtheo giờ Việt Nam, UTC+714.936 ca kiểm lịch3Can chinăm, tháng, ngày, giờ73.414 ngày, 1900 tới 21004Lá sốcục, cung Mệnh, Thân, 14 chính tinh, phụ tinh,sáng tối, Tứ Hóa, Tuần Triệt777 lá số khớp từng trường5Đại vận, hạn nămsao lưu theo năm xem12 đại vận, mỗi vận 10 năm6Cách cụctheo Tử Vi Đẩu Số Toàn Thư24 cách dựng được, 6 cáchkhông thể xảy ra7Câu sách cổkhớp đúng lá số885 đoạn trong bộziwei-knowledge8Lời luận13 phần, ba thứ tiếng3,6 triệu lá số luận sẵnBát Tự1Tiết khí tới phútlệch IMCCE 0,27 phút2Bốn trụnăm đổi ở Lập Xuân, tháng ở giờ giaotiết3Tàng can, thập thần777 lá số khớp từng trường4Đại vậnmỗi vận 10 năm5Câu sách cổtừ 7 sách cổĐộ sâu: từ vị trí Mặt Trời, Mặt Trăng tới lời luậnTử Vi: 1. Mặt Trời, Mặt Trăng (vị trí thật trên trời): điểm sóc trễ NASA trung bình 0,9 phút; 2. Lịch âm (theo giờ Việt Nam, UTC+7): 14.936 ca kiểm lịch; 3. Can chi (năm, tháng, ngày, giờ): 73.414 ngày, 1900 tới 2100; 4. Lá số (cục, cung Mệnh, Thân, 14 chính tinh, phụ tinh, sáng tối, Tứ Hóa, Tuần Triệt): 777 lá số khớp từng trường; 5. Đại vận, hạn năm (sao lưu theo năm xem): 12 đại vận, mỗi vận 10 năm; 6. Cách cục (theo Tử Vi Đẩu Số Toàn Thư): 24 cách dựng được, 6 cách không thể xảy ra; 7. Câu sách cổ (khớp đúng lá số): 885 đoạn trong bộ ziwei-knowledge; 8. Lời luận (13 phần, ba thứ tiếng): 3,6 triệu lá số luận sẵn. Bát Tự: 1. Tiết khí tới phút: lệch IMCCE 0,27 phút; 2. Bốn trụ: năm đổi ở Lập Xuân, tháng ở giờ giao tiết; 3. Tàng can, thập thần: 777 lá số khớp từng trường; 4. Đại vận: mỗi vận 10 năm; 5. Câu sách cổ: từ 7 sách cổ.Tử Vi1Mặt Trời, Mặt Trăngvị trí thật trên trờiđiểm sóc trễ NASA trung bình 0,9 phút2Lịch âmtheo giờ Việt Nam, UTC+714.936 ca kiểm lịch3Can chinăm, tháng, ngày, giờ73.414 ngày, 1900 tới 21004Lá sốcục, cung Mệnh, Thân, 14 chính tinh, phụ tinh, sáng tối,Tứ Hóa, Tuần Triệt777 lá số khớp từng trường5Đại vận, hạn nămsao lưu theo năm xem12 đại vận, mỗi vận 10 năm6Cách cụctheo Tử Vi Đẩu Số Toàn Thư24 cách dựng được, 6 cách không thể xảy ra7Câu sách cổkhớp đúng lá số885 đoạn trong bộ ziwei-knowledge8Lời luận13 phần, ba thứ tiếng3,6 triệu lá số luận sẵnBát Tự1Tiết khí tới phútlệch IMCCE 0,27 phút2Bốn trụnăm đổi ở Lập Xuân, tháng ở giờ giao tiết3Tàng can, thập thần777 lá số khớp từng trường4Đại vậnmỗi vận 10 năm5Câu sách cổtừ 7 sách cổ
Độ sâu: từ vị trí Mặt Trời, Mặt Trăng tới lời luận
Sai số giờ giao tiết so với IMCCE trên 4.824 mốc, trước và sau 19/11/2026trung bình 0,27 phút (trước: 4,2); 95% mốc dưới 0,6 phút (trước: 9,7); lớn nhất 0,9 phút (trước: 14,4). từ 19/11/2026: -2…0: 2565; 0…2: 2259. trước 19/11/2026: -16…-14: 8; -14…-12: 53; -12…-10: 138; -10…-8: 397; -8…-6: 603; -6…-4: 845; -4…-2: 893; -2…0: 821; 0…2: 544; 2…4: 338; 4…6: 126; 6…8: 52; 8…10: 6.trung bình0,27 phúttrước: 4,295% mốc dưới0,6 phúttrước: 9,7lớn nhất0,9 phúttrước: 14,4trước 19/11/2026từ 19/11/202601.0002.000−16−12−8−40481216phút so với IMCCE (âm: tính sớm hơn); cột: số mốcMốc rơi khác ngày với IMCCE: 10 trước, 0 nay
Sai 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.

Đọc chuyên sâu

Âm lịch Việt Nam khác Trung Quốc

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 21001903: VN 28/1, CN 29/1; 1916: VN 3/2, CN 4/2; 1935: VN 3/2, CN 4/2; 1965: VN 1/2, CN 2/2; 1968: VN 29/1, CN 30/1; 1969: VN 16/2, CN 17/2; 1985: VN 21/1, CN 20/2; 2007: VN 17/2, CN 18/2; 2030: VN 2/2, CN 3/2; 2053: VN 18/2, CN 19/21903VN 28/1CN 29/1+1 ngày1916VN 3/2CN 4/2+1 ngày1935VN 3/2CN 4/2+1 ngày1965VN 1/2CN 2/2+1 ngày1968VN 29/1CN 30/1+1 ngày1969VN 16/2CN 17/2+1 ngày1985VN 21/1CN 20/2+30 ngày2007VN 17/2CN 18/2+1 ngày2030VN 2/2CN 3/2+1 ngày2053VN 18/2CN 19/2+1 ngày190019502000205021002.814 ngày có ngày âm khác nhau giữa hai lịchVN: giờ Việt Nam (UTC+7); CN: giờ Bắc Kinh (UTC+8)10 năm Tết lệch giữa giờ Việt Nam và giờ Bắc Kinh, 1900 tới 21001903: VN 28/1, CN 29/1; 1916: VN 3/2, CN 4/2; 1935: VN 3/2, CN 4/2; 1965: VN 1/2, CN 2/2; 1968: VN 29/1, CN 30/1; 1969: VN 16/2, CN 17/2; 1985: VN 21/1, CN 20/2; 2007: VN 17/2, CN 18/2; 2030: VN 2/2, CN 3/2; 2053: VN 18/2, CN 19/21900200021001903VN 28/1 · CN 29/1+1 ngày1916VN 3/2 · CN 4/2+1 ngày1935VN 3/2 · CN 4/2+1 ngày1965VN 1/2 · CN 2/2+1 ngày1968VN 29/1 · CN 30/1+1 ngày1969VN 16/2 · CN 17/2+1 ngày1985VN 21/1 · CN 20/2+30 ngày2007VN 17/2 · CN 18/2+1 ngày2030VN 2/2 · CN 3/2+1 ngày2053VN 18/2 · CN 19/2+1 ngày2.814 ngày có ngày âm khác nhau giữa hai lịchVN: giờ Việt Nam (UTC+7); CN: giờ Bắc Kinh (UTC+8)
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ịchMúi giờDùng ở
Việt Nammặc địnhUTC+7Việt NamVN
Trung QuốcUTC+8Trung 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ốcUTC+9Hàn QuốcKR
Nhật BảnUTC+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.

Chọn lịch theo mã nước
import { toLunar } from "@nhatnguyet/lunar";

toLunar("1985-01-21", { lang: "vi" });                   // 1/1/1985, Ất Sửu
toLunar("1985-01-21", { lang: "vi", country: "CN" });  // 1/12/1984, Giáp Tý

Trong repo có gì?

Phiên bản 0.3.0: năm gói tính toán tên tiếng Anh, mỗi gói có bản tên Việt cùng mã; một gói Python ra đúng từng trường.

GóiLàm gì
@nhatnguyet/lunartên Việt: @nhatnguyet/am-lichĐổi âm dương lịch cho Việt Nam, Trung Quốc, Hàn Quốc, Nhật Bản và 7 vùng khác; can chi; 24 tiết khí tới phút; Nhị Thập Bát Tú; nạp âm; giờ hoàng đạo
@nhatnguyet/ziweitên Việt: @nhatnguyet/tu-viTử Vi: 12 cung, miếu vượng hãm, Tứ Hóa, Tuần Triệt, đại vận, hạn năm, sao lưu, cách cục kèm câu gốc, tuỳ chọn trường phái; vẽ SVG; lớp tương thích iztro
@nhatnguyet/bazitên Việt: @nhatnguyet/bat-tuBát Tự: bốn trụ theo tiết khí, tàng can, thập thần, thần sát, đại vận, tiểu vận; vẽ SVG
@nhatnguyet/numerologytên Việt: @nhatnguyet/than-so-hocThần số học Pythagoras, tên tiếng Việt có dấu; vẽ SVG
@nhatnguyet/festivalstên Việt: @nhatnguyet/le-hoi206 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/cliDòng lệnh: lá số thành lưới, JSON, SVG hay tệp .ics; Python có cùng lệnh nhatnguyet
@nhatnguyet/mcpMáy chủ MCP cho trợ lý AI, chạy trên máy
@nhatnguyet/widgets5 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.

Tuỳ chọnGiá trị (mặc định đứng đầu)Đổi gì
fireBellvietnamese, quanshu, swap-for-female, swap-for-yin-male-yang-femaleHỏa Tinh, Linh Tinh
leapMonthwhole, split-at-15, next-monthTháng dùng để an sao khi sinh tháng nhuận
transformationsvietnamese, quanshu, zhongzhouTứ Hóa của can Canh
heavenlyKitchenvietnamese, chineseThiên Trù năm Quý
injuryMessengerstandard, zhongzhouThiên Thương, Thiên Sứ
ziHournext-day-from-23, split-at-midnightBát Tự: trụ ngày của người sinh 23h tới 24h

Bộ dữ liệu

Giấy phép CC BY 4.0, dùng được cho sản phẩm thương mại và huấn luyện AI, miễn là ghi nguồn.

  • nhatnguyet/ziwei-readings: 1.761.936 lá số Tử Vi kèm lời luận ba thứ tiếng: mọi ngày 1900 tới 2100, 12 giờ, nam và nữ
  • nhatnguyet/bazi-readings: 1.761.936 lá số Bát Tự kèm lời luận, cùng khoảng
  • nhatnguyet/numerology-readings: 73.414 hồ sơ thần số học, mỗi ngày sinh một hồ sơ
  • nhatnguyet/ziwei-knowledge: 2.787 đơn vị tri thức Tử Vi (sao tại cung, cách cục...), lời luận ba thứ tiếng, 885 đoạn sách cổ
  • nhatnguyet/bazi-knowledge: 973 đơn vị Bát Tự, 1.589 đoạn sách cổ
  • nhatnguyet/numerology-knowledge: 143 đơn vị thần số học, 195 đoạn sách
  • 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ủÂm lịch 4 nước (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); 24 tiết khí (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Can chi (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Nhị Thập Bát Tú (Phương Đông): Thư viện mã (npm, PyPI); Xem ngày (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ), Thư viện mã sắp có; Tử Vi (Phương Đông): Thư viện mã (npm, PyPI); Bát Tự (Phương Đông): Thư viện mã (npm, PyPI); Kinh Dịch (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Phong thuỷ (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Thần số học (Phương Tây): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Chiêm tinh (Phương Tây): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Tarot (Phương Tây): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Lễ hội (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Văn cúng (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp cóPhương ĐôngPhương TâyLịch phápÂm lịch 4 nướcVN, CN, KR, JP24 tiết khí4.824 mốc giao tiếtCan chi60 hoa giápNhị Thập Bát Túsao trực từng ngàyXem ngàygiờ hoàng đạo; 12 trực sắp cóMệnh lý, thuậtsốTử Vi14 chính tinh, 12 cungBát Tựbốn trụ, thập thầnKinh Dịch64 quẻPhong thuỷcung phi, thước Lỗ BanThần số họctên tiếng ViệtChiêm tinh12 cung hoàng đạoTarot78 láTín ngưỡng,văn hoáLễ hội206 lễ, ngày từng nămVăn cúng456 bài, 155 loại lễThư viện mã (npm, PyPI)Dữ liệu mở (33 bộ)Thư viện mã sắp cóĐộ rộng: các lĩnh vực đã phủÂm lịch 4 nước (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); 24 tiết khí (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Can chi (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Nhị Thập Bát Tú (Phương Đông): Thư viện mã (npm, PyPI); Xem ngày (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ), Thư viện mã sắp có; Tử Vi (Phương Đông): Thư viện mã (npm, PyPI); Bát Tự (Phương Đông): Thư viện mã (npm, PyPI); Kinh Dịch (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Phong thuỷ (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Thần số học (Phương Tây): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Chiêm tinh (Phương Tây): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Tarot (Phương Tây): Dữ liệu mở (33 bộ), Thư viện mã sắp có; Lễ hội (Phương Đông): Thư viện mã (npm, PyPI), Dữ liệu mở (33 bộ); Văn cúng (Phương Đông): Dữ liệu mở (33 bộ), Thư viện mã sắp cóPhương ĐôngPhương TâyLịch phápÂm lịch 4 nướcVN, CN, KR, JP24 tiết khí4.824 mốc giao tiếtCan chi60 hoa giápNhị Thập Bát Túsao trực từng ngàyXem ngàygiờ hoàng đạo; 12 trực sắp cóMệnh lý, thuật sốTử Vi14 chính tinh, 12 cungBát Tựbốn trụ, thập thầnKinh Dịch64 quẻPhong thuỷcung phi, thước Lỗ BanThần số họctên tiếng ViệtChiêm tinh12 cung hoàng đạoTarot78 láTín ngưỡng, văn hoáLễ hội206 lễ, ngày từng nămVăn cúng456 bài, 155 loại lễThư viện mã (npm, PyPI)Dữ liệu mở (33 bộ)Thư viện mã sắp có
Độ rộng: các lĩnh vực đã phủ

Bắt đầu trong ba bước

  1. Cài gói

    Một lệnh cho JavaScript, một lệnh cho Python. Không cần máy chủ, không cần khoá.

    Dòng lệnh
    npm i @nhatnguyet/ziwei @nhatnguyet/lunar
    pip install nhatnguyet
    Một lõi tính, ba thứ dùng đượcLõi tính gốcđang chạy trên nhatnguyet.org và appkhớp từng trường qua 17.291 ca kiểmTypeScriptnpmPythonpipDữ liệu mở33 bộ, có DOI
  2. Gọi một hàm

    Lập lá số Tử Vi từ ngày giờ sinh dương lịch, giờ đồng hồ Việt Nam. lang chọn tiếng Việt, Anh hay Trung cho kết quả.

    TypeScript
    import { castZiWei, findPatterns } from "@nhatnguyet/ziwei";
    
    // 19/9/1990, 20 giờ (giờ Tuất)
    const chart = castZiWei({ date: "1990-09-19", time: "20:00", gender: "male", lang: "vi" });
    const patterns = findPatterns(chart);
    Python
    from nhatnguyet import cast_zi_wei, find_patterns
    
    # 19/9/1990, 20 giờ (giờ Tuất)
    chart = cast_zi_wei(date="1990-09-19", time="20:00", gender="male", lang="vi")
    patterns = find_patterns(chart)
    Ngày giờ sinh vào, lá số ra19/9/1990, giờ TuấtNamcastZiWei()Cục, cung Mệnh, cung Thân12 cung, 14 chính tinh, phụ tinhTứ Hóa, đại vận, hạn nămCách cục theo Toàn Thư
  3. Xem kết quả

    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
    Lá số Tử Vi rút gọn: 12 cung và chính tinhPhụ MẫuTýTham LangPhúc ĐứcSửuThiên ĐồngKhoaCự MônĐiền TrạchDầnVũ KhúcQuyềnThiên TướngQuan LộcMãoThái DươngLộcThiên LươngNô BộcThìnThất SátThiên DiTỵThiên CơTật ÁchNgọTử ViTài BạchMùiThânTử TứcThânPhá QuânPhu ThêDậuHuynh ĐệTuấtLiêm TrinhThiên PhủMệnhHợiThái ÂmKỵCanh Ngọ19/9/1990, giờ TuấtThổ Ngũ CụcMệnh ở Hợi

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.

Trích dẫn thư viện
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.