开发产品
应用、网站、日历:命盘、阴阳历换算、黄道吉时、节庆,直接在用户设备上计算。
开放代码与数据
JavaScript、Python 程序库与开放数据,用于排命盘、换算农历、查黄道吉时、查节庆与祭文。面向产品开发、研究与人工智能工作者。
在于做法,而不在于预测。
1900 至 2100 年间有 2,814 天按越南时间与北京时间的农历日期不同。有 10 年春节日期不同,最明显的是 1985 年:越南1月21日过年,中国2月20日。
程序库可选择各国历法,默认越南历。
| 历法 | 时区 | 适用 |
|---|---|---|
| 越南默认 | UTC+7 | 越南VN |
| 中国 | UTC+8 | 中国、台湾、香港、澳门;新加坡、马来西亚、印度尼西亚、菲律宾华人的春节CN, TW, HK, MO, SG, MY, ID, PH |
| 韩国 | UTC+9 | 韩国KR |
| 日本 | UTC+9 | 旧历(kyūreki),用于传统节日JP |
蒙古、西藏、泰国、老挝、柬埔寨、缅甸、印度使用规则不同的历法,程序库尚未收录。
import { toLunar } from "@nhatnguyet/lunar";
toLunar("1985-01-21", { lang: "zh" }); // 1985 年正月初一,乙丑
toLunar("1985-01-21", { lang: "zh", country: "CN" }); // 1984 年腊月初一,甲子版本 0.3.0:五个英文名的计算包,各有同一代码的越南语名版本;一个 Python 包,结果逐字段一致。
| 程序包 | 功能 |
|---|---|
@nhatnguyet/lunar又名 @nhatnguyet/am-lich | 越南、中国、韩国、日本及另外 7 个地区的阴阳历换算;干支;精确到分钟的二十四节气;二十八宿;纳音;黄道吉时 |
@nhatnguyet/ziwei又名 @nhatnguyet/tu-vi | 紫微斗数:十二宫、庙旺利陷、四化、旬空截空、大限、流年、流曜、附古籍原文的格局、流派选项;SVG;兼容 iztro 的接口 |
@nhatnguyet/bazi又名 @nhatnguyet/bat-tu | 八字:按节气定四柱、藏干、十神、神煞、大运、小运;SVG |
@nhatnguyet/numerology又名 @nhatnguyet/than-so-hoc | 毕达哥拉斯数字命理,支持带声调的越南姓名;SVG |
@nhatnguyet/festivals又名 @nhatnguyet/le-hoi | 206 个越南节庆及其逐年日期、省份、民族、举办地;可导出 iCalendar(.ics) |
@nhatnguyet/cli | 命令行:命盘以表格、JSON、SVG 或 .ics 文件输出;Python 版有同样的 nhatnguyet 命令 |
@nhatnguyet/mcp | 供 AI 助手使用的 MCP 服务器,在本机运行 |
@nhatnguyet/widgets | 5 个网页组件:今日、月历、黄道吉时、春节倒计时、日期换算 |
nhatnguyet (PyPI) | 以上全部功能合为一个 Python 包,结果逐字段一致 |
各书安星不同之处,程序库选定一个默认值、注明所依之书,并可用 schools 切换。默认值永不改变;432 个测试用例专门覆盖这些选项。采用《全书》的三个选项后,与 iztro 在 610 张命盘上的差异:火铃(484)、庚干四化(126)、癸年天厨(59)都降为 0。
| 选项 | 取值(默认在前) | 影响 |
|---|---|---|
fireBell | vietnamese, quanshu, swap-for-female, swap-for-yin-male-yang-female | 火星、铃星 |
leapMonth | whole, split-at-15, next-month | 闰月出生时安星所用的月份 |
transformations | vietnamese, quanshu, zhongzhou | 庚干四化 |
heavenlyKitchen | vietnamese, chinese | 癸年天厨 |
injuryMessenger | standard, zhongzhou | 天伤、天使 |
ziHour | next-day-from-23, split-at-midnight | 八字:23 点至 24 点出生的日柱 |
CC BY 4.0 许可:可用于商业产品与 AI 训练,须注明来源。
nhatnguyet/ziwei-readings: 1761936 份紫微命盘及三语解读:1900 至 2100 年每日、12 个时辰、男女nhatnguyet/bazi-readings: 1761936 份八字命盘及解读,范围相同nhatnguyet/numerology-readings: 73414 份数字命理档案,每个出生日期一份nhatnguyet/ziwei-knowledge: 2787 个紫微知识单元(星曜落宫、格局等),三语解读,885 段古籍原文nhatnguyet/bazi-knowledge: 973 个八字单元,1589 段古籍原文nhatnguyet/numerology-knowledge: 143 个数字命理单元,195 段文献nhatnguyet/sach-co: 373 份公有领域古籍全文,共 7270 万字nhatnguyet/classical-parallel: 1328 组《易经》对齐段落:文言原文与公有领域英译(952)、法译(376)terminology(在仓库中): 416 个术语:越南语、繁简汉字、拼音、英语ai-eval(在仓库中): 1520 道由程序计算答案的问题(农历日期、春节、干支、命盘),三种语言,用于评测语言模型history(在仓库中): 1900 至 2100 年按 UTC+7 与 UTC+8 计算的春节,附越南实际使用的历法与出处MCP 服务器(npx -y @nhatnguyet/mcp)让 AI 助手调用计算而非猜测:历法换算、节气、黄道吉时、紫微、八字、数字命理、节庆、SVG 命盘。四个可直接使用的项目模板:
nextjs-lunar-calendar: Next.js 农历页面:带农历与节气的月历、春节倒计时、表单排紫微命盘telegram-bot: Telegram 机器人:/today、/tet、/ziwei,三种语言回复google-sheets: Google 表格函数 =LUNARDATE()、=SEXAGENARY()、=SOLARTERM()、=SOLARDATE(),一个文件即可jupyter: Jupyter 笔记本:1900 至 2100 年越南与中国的春节与闰月,附图表应用、网站、日历:命盘、阴阳历换算、黄道吉时、节庆,直接在用户设备上计算。
数百万组三语命盘与解读可用于训练;带出处的古籍段落可供助手与检索使用。
统计全部出生日期的格局频率与星曜分布;用数据比较各国历法。
测试用例是任何紫微、八字、农历程序库的通用答案,适用于任何编程语言。
JavaScript 一条命令,Python 一条命令。无需服务器,无需密钥。
npm i @nhatnguyet/ziwei @nhatnguyet/lunar
pip install nhatnguyet以公历出生日期与钟点时间排紫微命盘。lang 选择结果的语言:中文、英文或越南文。
import { castZiWei, findPatterns } from "@nhatnguyet/ziwei";
// 1990年9月19日,20点(戌时)
const chart = castZiWei({ date: "1990-09-19", time: "20:00", gender: "male", lang: "zh" });
const patterns = findPatterns(chart);from nhatnguyet import cast_zi_wei, find_patterns
# 1990年9月19日,20点(戌时)
chart = cast_zi_wei(date="1990-09-19", time="20:00", gender="male", lang="zh")
patterns = find_patterns(chart)此命盘命宫在亥,土五局,识别出四个格局。
chart.bureau.name // "土五局"
chart.palaces[chart.lifePalace].branch // "亥"
chart.palaces[chart.lifePalace].stars[0] // 太阴(庙,化忌)
patterns.map((p) => p.name)
// "机月同梁", "左右同会", "日出扶桑", "月落亥宫"Copyright (c) 2026 Nhat Nguyet (nhatnguyet.org)。数据:Nhat Nguyet(nhatnguyet.org)。展示结果的应用须在用户可见处注明“据 Nhat Nguyet”;研究请引用 DOI。使用程序库的研究请引用程序库的 DOI;使用数据集的研究请引用数据集的 DOI。两个概念 DOI 始终指向最新版本。
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@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}
}完整命盘:五行局、命宫、身宫、十四主星与辅星、庙旺利陷、四化、旬空截空、大限、流年、流曜。格局包含《紫微斗数全书》所列诸格。
五个用于计算的 npm 包和一个 Python 包。 npm:@nhatnguyet/lunar、ziwei、bazi、numerology、festivals(与越南语名的 am-lich、tu-vi、bat-tu、than-so-hoc、le-hoi 为同一代码),另有 cli、mcp、widgets。Python:pip install nhatnguyet 包含全部五部分。
可以,依据 CC BY 4.0 许可。唯一条件是注明“数据:Nhat Nguyet(nhatnguyet.org)”。
按节气,合乎四柱法:年柱于立春交换,月柱于交节之日交换,而非农历初一。
两门各守其法:八字自23点起换日,紫微按所输入的日期。因此两张命盘可能落在不同日期;紫微命盘附有子时说明。
先去掉声调,再按毕达哥拉斯表计算,“Đ”按“D”计。包含生命灵数、使命数、灵魂数、人格数、态度数、巅峰数、挑战数,以及个人年、月、日。