认识 iztro:轻量级紫微斗数排盘 JS 库
iztro 是一款专门为开发者打造的 JavaScript 开源库,旨在提供高效、轻量的紫微斗数排盘计算能力。它支持多语言输入与输出,开发者只需传入出生日期、具体时间及性别,即可快速获取完整的紫微斗数星盘数据。
除了基础的星盘排布,iztro 还涵盖了复杂的运限计算(包括大限、小限、流年、流月、流日、流时)以及流耀(大限与流年的动态星耀)等高级功能,非常适合需要将命理排盘集成到 Web 应用中的开发者学习与研究。
核心功能清单
iztro 提供了丰富的 API,能够覆盖绝大多数的排盘分析需求:
- 运限与流耀: 获取大限、小限、流年、流月、流日、流时的详细数据,以及对应的动态流耀。
- 宫位判定: 检查指定宫位或其三方四正中是否存在特定星耀或四化,并支持判断是否为「空宫」。
- 星耀分析: 判定星耀的亮度、是否携带四化,以及星耀在三方四正中的分布情况。
- 位置查询: 快速获取指定星耀所在的宫位、对宫,或指定宫位的三方四正关系。
- 运限联动: 获取指定运限的宫位及其三方四正,并判定其中的星耀与四化分布。
- 基础转换: 支持根据天干直接获取对应的四化信息。
背景知识:紫微斗数与排盘
紫微斗数 是中国传统的命理学方法。它通过农历的出生年、月、日、时来构建个人命盘,以推演吉凶。与西方占星术依赖星历不同,紫微斗数将命盘分为十二宫垣,以干支为经纬,将中天、北斗、南斗诸星及神煞罗布其中。
排盘 则是将出生时间转化为特定符号的计算过程,是研究紫微斗数的第一步。由于其计算逻辑极其复杂,现代用户通常依赖软件或网页工具(如搜索「紫微斗数在线排盘」或使用相关 App)来快速生成星盘。
快速上手资源
如果你想在项目中集成该库或进行研究,可以通过以下链接获取资源:
- 源码仓库: GitHub – SylarLong/iztro(查看代码实现与贡献)
- 技术文档: ziwei.pro(了解 API 详细用法)
- 在线演示: ziwei.pub(直接体验排盘效果)
正文完

