lunar-python大运流年流月一次搞懂:eightchar模块(Yun/DaYun/LiuNian/LiuYue)完整实战

原创2026-11-02 14:34:411,889 阅读

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 的大运流年流月推算就一次搞定了。

登录后查看全文
lunar-python