lunar-python大运流年流月一次搞懂:eightchar模块(Yun/DaYun/LiuNian/LiuYue)完整实战
lunar-python大运流年流月一次搞懂:eightchar模块(Yun/DaYun/LiuNian/LiuYue)完整实战
lunar-python 是一款无第三方依赖的中国日历工具库,除了公历、农历、节气、节日之外,还支持八字排盘和大运、流年、流月推算。本文带你一次搞懂 eightchar 模块中 Yun(运)→ DaYun(大运)→ LiuNian(流年)→ LiuYue(流月) 四个类的关系与用法,几分钟即可完成实战。
📌 先搞清楚:四个概念的关系
很多人第一次接触排盘类库都会晕:大运、流年、流月到底是什么关系?其实它就是一条"时间金字塔":
| 层级 | 对应类 | 含义 | 周期 |
|---|---|---|---|
| 运 | Yun |
大运排盘的"总开关",负责算起运时间和顺逆 | 整体 |
| 大运 | DaYun |
每 10 年一步,共可查 10 步(默认) | 10 年 |
| 流年 | LiuNian |
某一步大运下的逐年干支 | 1 年 |
| 流月 | LiuYue |
某一年下的 12 个月干支 | 1 月 |
调用链非常直观:
EightChar.getYun()→Yun.getDaYun()→DaYun.getLiuNian()→LiuNian.getLiuYue()
这条链在 demo.py 中有完整示例,源码则分别位于 Yun.py、DaYun.py、LiuNian.py、LiuYue.py。
🚀 第一步:从八字对象获取运(getYun)
一切从八字对象开始。Yun 的构造函数有两个关键参数(见 EightChar.py 的 getYun):
gender:1 表示男,0 表示女——性别决定大运是顺排还是逆排(阳年男命、阴年女命顺排,反之逆排);sect:流派,默认1按"3天折1年、1天折4个月、1时辰折10天"折算,2则按分钟数精确折算(4320分钟=1年)。
最简调用示例:
from lunar_python import Solar
solar = Solar.fromYmdHms(1981, 1, 29, 23, 37, 0)
yun = solar.getLunar().getEightChar().getYun(0) # 0 表示女命
📅 第二步:查看起运时间与顺逆
Yun 类提供了以下常用方法:
| 方法 | 说明 |
|---|---|
getStartYear() |
起运年数 |
getStartMonth() |
起运月数 |
getStartDay() |
起运天数 |
getStartSolar() |
起运的阳历日期(最实用) |
isForward() |
是否顺排(true/false) |
getDaYun(n) |
获取 n 步大运,默认 10 步 |
以 YunTest.py 中的测试用例为例,1981-01-29 23:37 出生的女命,起运年为 8 年 0 月 20 天,getStartSolar() 直接算出起运日期是 1989-02-18,无需自己按节气折算。
🎯 第三步:查询大运(DaYun)
yun.getDaYun(10) 返回 10 步大运的列表,其中第 0 步是"起运前"的过渡段(干支为空字符串),从第 1 步开始才是正式的大运。每一步大运都是 10 年一个周期,可用方法:
| 方法 | 说明 |
|---|---|
getGanZhi() |
大运干支,如"丙子" |
getStartYear() / getEndYear() |
大运起止年份(公历年) |
getStartAge() / getEndAge() |
大运起止虚岁 |
getXun() / getXunKong() |
所在旬 / 旬空(空亡) |
getLiuNian(n) |
该步大运下的流年列表 |
getXiaoYun(n) |
该步大运下的小运列表 |
da_yun_arr = yun.getDaYun()
for i in range(len(da_yun_arr)):
d = da_yun_arr[i]
print(d.getStartYear(), '年', d.getStartAge(), '岁', d.getGanZhi())
输出效果与 demo.py 一致,例如 1989年 9岁 丙子。
📆 第四步:流年与流月批量查询
流年(LiuNian):对任意一步大运调用 getLiuNian() 即可拿到该步大运覆盖的逐年干支,每个流年对象提供 getYear()(公历年)、getAge()(虚岁)、getGanZhi()、getXun()、getXunKong(),见 LiuNian.py。
流月(LiuYue):对任意一个流年调用 getLiuYue() 返回 12 个月,getMonthInChinese() 返回"正、二、三…",getGanZhi() 按"五虎遁"口诀自动推导月干(甲己之年丙作首……),源码逻辑见 LiuYue.py。
liu_nian_arr = da_yun_arr[1].getLiuNian()
liu_yue_arr = liu_nian_arr[0].getLiuYue()
for i in range(12):
print(liu_yue_arr[i].getMonthInChinese(), '月', liu_yue_arr[i].getGanZhi())
🌱 补充:小运(XiaoYun)
起运前的年份没有大运,传统上用小运作为参考。DaYun.getXiaoYun() 与小运干支的推导逻辑(按时柱起、随顺逆排)在 XiaoYun.py 中实现,用法与流年类似。
❓ 常见疑问速答
- 性别参数搞反会怎样? 顺逆排直接颠倒,起运日期和大运干支都会变,务必传对(1男 / 0女)。
- 起运日期按哪个流派? 默认
sect=1用"3天=1年"的粗算;getYun(1, 2)则按分钟精算,两种流派在 YunTest.py 中有对照用例。 - 第 0 步大运的干支为什么是空? 第 0 步是出生到起运之间的过渡段,尚未进入正式大运,
getGanZhi()约定返回空字符串。
📚 相关文件速查
| 文件 | 内容 |
|---|---|
| lunar_python/eightchar/Yun.py | 运:起运计算、顺逆排 |
| lunar_python/eightchar/DaYun.py | 大运:干支、年龄、旬空 |
| lunar_python/eightchar/LiuNian.py | 流年:年度干支与虚岁 |
| lunar_python/eightchar/LiuYue.py | 流月:五虎遁推月干支 |
| lunar_python/eightchar/XiaoYun.py | 小运:起运前的参考运 |
| lunar_python/EightChar.py | 八字对象与 getYun 入口 |
| demo.py | 大运/流年/流月完整输出示例 |
| test/YunTest.py | 起运日期计算测试用例 |
掌握 Yun → DaYun → LiuNian → LiuYue 这条链,lunar-python 的大运流年流月推算就一次搞定了。