用 JavaScript 在网站上排紫微命盘:逐步教程

在浏览器里排紫微命盘,只需要一个包:@nhatnguyet/tu-vi。 它计算五行局、命宫、身宫,安十四主星与辅星、庙旺、四化、旬空截空、大运、流年和格局,不调用任何服务器。本文从安装命令一直讲到网页上的十二宫格。
开始前需要什么?
- Node 22 或更高版本,或任何能运行 ES 模块的浏览器。
- 当事人的公历出生日期、出生时辰和性别。
排盘步骤
- 安装包。它会一并安装换算农历的
@nhatnguyet/am-lich。 - 调用
lapLaSoTuVi(hoTen, gioiTinh, ngay, thang, nam, gio)。性别为"Nam"(男)或"Nữ"(女);时辰是地支序号,0 为子,6 为午,11 为亥。 - 读取
laSo.cung:按地支排列的十二宫数组,每宫带宫名、干支和星曜列表。 - 调用
nhanDienCachCuc(laSo)取格局,tinhHanNam(laSo, 2026)取当年的流年、小限和大运。 - 把十二宫画到页面的 4x4 网格上。
npm i @nhatnguyet/tu-vi完整代码与输出
示例为 1990 年 2 月 17 日午时出生的女性排盘。函数返回越南语术语并附英文名;主星的汉字名用 saoZh 取得。
import { lapLaSoTuVi, nhanDienCachCuc, tinhHanNam, saoZh } from "@nhatnguyet/tu-vi";
const CUNG = { "Mệnh": "命宫", "Phụ Mẫu": "父母", "Phúc Đức": "福德", "Điền Trạch": "田宅", "Quan Lộc": "官禄", "Nô Bộc": "奴仆",
"Thiên Di": "迁移", "Tật Ách": "疾厄", "Tài Bạch": "财帛", "Tử Tức": "子女", "Phu Thê": "夫妻", "Huynh Đệ": "兄弟" };
const HOA = { "Hóa Lộc": "化禄", "Hóa Quyền": "化权", "Hóa Khoa": "化科", "Hóa Kỵ": "化忌" };
// 女,1990 年 2 月 17 日生,午时(地支序号:0 为子,6 为午)
const laSo = lapLaSoTuVi("", "Nữ", 17, 2, 1990, 6);
const am = laSo.ngaySinhAm;
console.log(`农历 ${am.year} 年 ${am.month} 月 ${am.day} 日,${laSo.canChiNam} 年`);
console.log(`${laSo.amDuongMenh},${laSo.tenCuc},纳音 ${laSo.banMenhNapAm}`);
for (const c of laSo.cung) {
const xing = c.sao
.filter((s) => s.loai === "chinh-tinh")
.map((s) => saoZh(s.ten) + (s.tuHoa ? `(${HOA[s.tuHoa]})` : ""));
const biao = c.viTri === laSo.cungMenh ? " <- 命宫" : "";
console.log(c.chi.padEnd(5), CUNG[c.tenCung].padEnd(4), xing.join("、") || "无主星", biao);
}
console.log("格局:", nhanDienCachCuc(laSo).map((c) => c.tenZh).join("、"));
const han = tinhHanNam(laSo, 2026);
console.log(`${han.canChiNam} 年:流年在${CUNG[han.luuNienTenCung]},大运 ${han.daiVanTuTuoi} 至 ${han.daiVanDenTuoi} 岁`);运行 node lap-la-so.mjs:
农历 1990 年 1 月 22 日,Canh Ngọ 年
Dương Nữ,Thủy Nhị Cục,纳音 Lộ Bàng Thổ
Tý 官禄 紫微
Sửu 奴仆 无主星
Dần 迁移 破军
Mão 疾厄 无主星
Thìn 财帛 廉贞、天府
Tỵ 子女 太阴(化忌)
Ngọ 夫妻 贪狼
Mùi 兄弟 天同(化科)、巨门
Thân 命宫 武曲(化权)、天相 <- 命宫
Dậu 父母 太阳(化禄)、天梁
Tuất 福德 七杀
Hợi 田宅 天机
格局: 紫府武相
Bính Ngọ 年:流年在夫妻,大运 32 至 41 岁
1990 年 2 月 17 日是庚午年正月廿二,命宫在申,有武曲、天相,所以函数识别出紫府武相一组。每个格局都附三种语言的条件和说明(dieuKien、dieuKienEn、dieuKienZh);出自《紫微斗数全书》的格局另有 nhom 和书中原注。
怎样把命盘放到网页上?
传统命盘把巳宫放在左上角,顺时针排列,中间四格写资料。下面的函数把这个网格生成 HTML;chiGioTuGioDongHo 把钟点换成地支序号。
import { lapLaSoTuVi, saoZh } from "@nhatnguyet/tu-vi";
import { chiGioTuGioDongHo } from "@nhatnguyet/am-lich";
// 十二宫在 4x4 网格上的位置(地支序号:0 子 ... 11 亥),null 为中间格
const LUOI = [5, 6, 7, 8, 4, null, null, 9, 3, null, null, 10, 2, 1, 0, 11];
function veLaSo(laSo) {
const o = LUOI.map((v) => {
if (v === null) return "";
const c = laSo.cung[v];
const sao = c.sao.filter((s) => s.loai === "chinh-tinh").map((s) => saoZh(s.ten)).join("、");
return `<div class="cung"><small>${c.canChi}</small><b>${c.tenCung}</b><p>${sao}</p></div>`;
});
return `<div class="la-so">${o.join("")}</div><p class="nguon">据 Nhat Nguyet</p>`;
}
const gio = chiGioTuGioDongHo(11); // 上午 11 点为午时
const html = veLaSo(lapLaSoTuVi("", "Nữ", 17, 2, 1990, gio));
console.log("时辰序号:", gio);
console.log(html.slice(0, 160));时辰序号: 6
<div class="la-so"><div class="cung"><small>Tân Tỵ</small><b>Tử Tức</b><p>太阴</p></div><div class="cung"><small>Nhâm Ngọ</small><b>Phu Thê</b><p>贪狼</p></div><div再加上 4 列 4 行的 CSS 网格,就得到下图。图由同一个 laSo 对象生成,另加庙旺、四化、六吉六煞、长生十二神和旬空截空。

常见误区
- 23 点至 0 点出生:函数沿用输入的公历日期,有的书算作次日。此时命盘带
ghiChuGioTyZh说明,应展示给用户。 - 庚、辛、壬三干的四化有异说。 庚干用天同化科、太阴化忌,即越南常用的说法。
- 尚未安:火星、铃星、红鸾、天刑、流昌、流曲。
- 性别不是
"Nam"、"Nữ",或时辰不在 0 到 11 之间,函数会抛出Error;请在表单里处理。
命盘严格按所用派别的安星规则算出。代码只保证规则用对了;至于这些规则对人生说得准不准,并未经过检验。
注明出处
代码采用 MIT 许可,数据采用 CC BY 4.0。向用户展示结果时,在看得到的地方注明“据 Nhat Nguyet”;再发布数据时,注明“数据:Nhat Nguyet (nhatnguyet.org)”。 代码库、文档和测试用例见开源页面。
想和网站结果对照,可打开紫微工具输入同样的日期时辰。



