cnlunar：让Python轻松玩转中国农历！无需数据库的黄历算法神器

曹爱蕙Egbert

292人浏览 · 2026-07-28 07:30:21

曹爱蕙Egbert · 2026-07-28 07:30:21 发布

cnlunar：让Python轻松玩转中国农历！无需数据库的黄历算法神器

【免费下载链接】cnlunar 农历，中国农历历法项目，无需数据库环境，以《钦定协纪辨方书》为核心的python3 农历、黄历、二十四节气、节假日、星次、每日凶煞、每日值神、农历建除十二神、农历每日宜忌、彭祖百忌、每日五行、二十八星宿、天干地支、农历生辰八字、时辰凶吉等开源项目。项目地址: https://gitcode.com/gh_mirrors/cn/cnlunar

cnlunar是一款基于Python的开源农历算法项目，无需数据库环境，以《钦定协纪辨方书》为核心，提供农历、黄历、二十四节气、节假日、星次、每日凶煞、值神、农历建除十二神、宜忌、彭祖百忌、五行、二十八星宿、天干地支、生辰八字、时辰凶吉等丰富功能，让开发者和普通用户都能轻松玩转中国农历。

🌟 为什么选择cnlunar？

精准可靠的算法核心

传统农历计算常采用"通用寿星公式"，存在200年内22个矫正值的缺陷，容易导致节气日期、八字月柱等数据错误。cnlunar摒弃这一经验公式，直接采用香港天文台1901-2100年的天文观测数据，通过向量压缩技术存储节气信息，确保阴阳合历计算的科学性和准确性。

丰富全面的文化传承

项目深度整合《四库全书·钦定协纪辨方书》内容，不仅实现公历农历转换、二十四节气计算等基础功能，还包含：

传统黄历元素：每日宜忌、十二神、二十八星宿、彭祖百忌
命理相关：八字四柱、天干地支、纳音五行
民俗文化：农历节日、时辰凶吉、中医时辰经络

轻量便捷的使用体验

零数据库依赖：所有数据通过十六进制压缩存储于代码中，无需额外配置
跨平台兼容：支持Windows、macOS、Linux系统，可用于web和移动端开发
极简安装：一条命令即可完成部署，提供详细demo用例

🚀 快速上手教程

安装步骤

通过pip命令快速安装：

pip install cnlunar

基础使用示例

import datetime
import cnlunar

# 初始化农历对象（支持指定日期和八字算法类型）
a = cnlunar.Lunar(datetime.datetime(2022, 11, 14, 10, 30), godType='8char')

# 获取核心农历信息
print({
    '农历数字': (a.lunarYear, a.lunarMonth, a.lunarDay, '闰' if a.isLunarLeapMonth else ''),
    '农历': f'{a.lunarYearCn} {a.year8Char}[{a.chineseYearZodiac}]年 {a.lunarMonthCn}{a.lunarDayCn}',
    '今日节气': a.todaySolarTerms,
    '下一节气': (a.nextSolarTerm, a.nextSolarTermDate, a.nextSolarTermYear),
    '今年节气表': a.thisYearSolarTermsDic
})