{"id":15297376,"url":"https://github.com/opn48/cnlunar","last_synced_at":"2026-02-04T11:28:25.611Z","repository":{"id":43602764,"uuid":"178248211","full_name":"OPN48/cnlunar","owner":"OPN48","description":"农历，中国农历历法项目，无需数据库环境，以《钦定协纪辨方书》为核心的python3 农历、黄历、二十四节气、节假日、星次、每日凶煞、每日值神、农历建除十二神、农历每日宜忌、彭祖百忌、每日五行、二十八星宿、天干地支、农历生辰八字、时辰凶吉等开源项目。","archived":false,"fork":false,"pushed_at":"2025-02-14T07:47:56.000Z","size":529,"stargazers_count":726,"open_issues_count":29,"forks_count":175,"subscribers_count":22,"default_branch":"master","last_synced_at":"2026-01-05T18:53:20.176Z","etag":null,"topics":["calendar","chinese-lunar-calendar","cnlunar","lunar","lunarcalendar","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OPN48.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-28T17:04:13.000Z","updated_at":"2026-01-05T09:22:14.000Z","dependencies_parsed_at":"2024-05-29T11:56:32.106Z","dependency_job_id":"0a9721d8-4b53-48aa-9896-5cf8e379603e","html_url":"https://github.com/OPN48/cnlunar","commit_stats":{"total_commits":152,"total_committers":1,"mean_commits":152.0,"dds":0.0,"last_synced_commit":"9b793d41c36760b1f8cadad800e5033cd93e377d"},"previous_names":["opn48/pylunarcalendar"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/OPN48/cnlunar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OPN48%2Fcnlunar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OPN48%2Fcnlunar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OPN48%2Fcnlunar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OPN48%2Fcnlunar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OPN48","download_url":"https://codeload.github.com/OPN48/cnlunar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OPN48%2Fcnlunar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28939508,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T10:18:23.202Z","status":"ssl_error","status_checked_at":"2026-01-31T10:18:22.693Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calendar","chinese-lunar-calendar","cnlunar","lunar","lunarcalendar","python","python3"],"created_at":"2024-09-30T19:16:58.909Z","updated_at":"2026-02-04T11:28:25.604Z","avatar_url":"https://github.com/OPN48.png","language":"Python","readme":"# cnlunar\n\u003ch1\u003e项目优点\u003c/h1\u003e\n1、不使用寿星通式[Y*D+C]-L，而使用香港天文台数据（阴阳合历，节气准农历日期才能准）\n\n2、无数据库，依赖库少，运行快速，提供内容丰富\n\n3、主要内容来自于《钦定协纪辨方书》，每一个神煞宜忌都有依据，遵循宜忌等第表，包含民用、御用事宜，且支持港式（通书配图）八字月柱算法-默认，通书原文文字农历月份算法，具体看demo.py\n\n4、不盈利，开源免费，长期有人维护\n\n5、民俗社会科学项目，不搞封建迷信，宜忌意义在于民间是将红白事合理分开，避免今日您宴请宾客，邻居办白事情况出现，引起邻里纠纷社会分裂。\n\n特别鸣谢 contributor\n\n@zither (https://github.com/zither ) issues/54\n\n@DarkmoonRabbit (https://github.com/DarkmoonRabbit)\n\n@JeremyYoungCai (https://github.com/JeremyYoungCai) issues/37\n\n@kingsoen (https://github.com/kingsoen) issues/40\n\n@Sonic853 (https://github.com/Sonic853) issues/41\n\n@IcyTide (https://github.com/IcyTide) issues/53\n\n其他与本项目关联项目：\n\n@zither 的 js版本 https://github.com/zither/cnlunar-js\n\n@m11v 的 Dart/Flutter版本 https://github.com/m11v/chinese_lunar_calendar\n\n@Crazydear 的kotlin版本 https://github.com/Crazydear/Android-Project/tree/main/cnLunar\n\n@jymusic0663 的 flask 版本 https://github.com/jymusic0663/cnlunar/\n\n@Sonic853 的 C# VRChat 版本 https://github.com/Sonic853/UdonCnLunar\n\n使用本开源项目的相关产品：\n\n翻黄历 https://www.fanhuangli.com/\n\n万年历-最新专业桌面老黄‪历 https://apps.apple.com/cn/app/id1555822960\n\n其他优秀的无依赖农历项目：\n\n@6tail 的 https://github.com/6tail/lunar-python\n```\n$ pip3 install cnlunar\n```\n\u003ch1\u003e快速上手\u003c/h1\u003e\n\n```\nimport datetime\nimport cnlunar\n\na = cnlunar.Lunar(datetime.datetime(2022, 11, 14, 10, 30), godType='8char')  # 常规算法\n\ndic = {\n    '日期': a.date,\n    '农历数字': (a.lunarYear, a.lunarMonth, a.lunarDay, '闰' if a.isLunarLeapMonth else ''),\n    '农历': '%s %s[%s]年 %s%s' % (a.lunarYearCn, a.year8Char, a.chineseYearZodiac, a.lunarMonthCn, a.lunarDayCn),\n    '星期': a.weekDayCn,\n    # 未增加除夕\n    '今日节日': (a.get_legalHolidays(), a.get_otherHolidays(), a.get_otherLunarHolidays()),\n    '八字': ' '.join([a.year8Char, a.month8Char, a.day8Char, a.twohour8Char]),\n    '今日节气': a.todaySolarTerms,\n    '下一节气': (a.nextSolarTerm, a.nextSolarTermDate, a.nextSolarTermYear),\n    '今年节气表': a.thisYearSolarTermsDic,\n    '季节': a.lunarSeason,\n\n    '今日时辰': a.twohour8CharList,\n    '时辰凶吉': a.get_twohourLuckyList(),\n    '生肖冲煞': a.chineseZodiacClash,\n    '星座': a.starZodiac,\n    '星次': a.todayEastZodiac,\n\n    '彭祖百忌': a.get_pengTaboo(),\n    '彭祖百忌精简': a.get_pengTaboo(long=4, delimit='\u003cbr\u003e'),\n    '十二神': a.get_today12DayOfficer(),\n    '廿八宿': a.get_the28Stars(),\n\n    '今日三合': a.zodiacMark3List,\n    '今日六合': a.zodiacMark6,\n    '今日五行': a.get_today5Elements(),\n\n    '纳音': a.get_nayin(),\n    '九宫飞星': a.get_the9FlyStar(),\n    '吉神方位': a.get_luckyGodsDirection(),\n    '今日胎神': a.get_fetalGod(),\n    '神煞宜忌': a.angelDemon,\n    '今日吉神': a.goodGodName,\n    '今日凶煞': a.badGodName,\n    '宜忌等第': a.todayLevelName,\n    '宜': a.goodThing,\n    '忌': a.badThing,\n    '时辰经络': a.meridians\n}\nfor i in dic:\n    midstr = '\\t' * (2 - len(i) // 2) + ':' + '\\t'\n    print(i, midstr, dic[i])\n```\n\n\u003ch1\u003e一、序言\u003c/h1\u003e\n    历法是基于人们生产活动需要，依据太阳、月亮等天象而制订计算时间的方法，根据月亮的周期变化所订立的历法称为阴历，根据太阳在不同季节的位置的周期变化所订立的历法称为阳历。\n因为月亮的周期变化较短，观测方式较为简单，所以阴历在世界各地普遍比阳历更早出现，比如我国的上古六历：黄帝历、夏历、殷历、周历、鲁历、颛顼历，古希腊的希腊历等。大约公元前104年至84年，以农耕文化为主的中国西汉，汉武帝刘彻责成邓平、唐都、落下闳等人编写了《太初历》，中国农历经历了第一次重大改革，引入二十四节气正式成为阴阳合历，历法在中国也成为了一门较为独立的科学技术。与之同一时期，公元前46年，罗马统帅凯撒大帝（Gaius Julius Caesar）在希腊数学家兼天文学家索西琴尼的帮助下制订《儒略历》（Julian calendar）取代旧罗马历法，《儒略历》以回归年为基本单位，是一部纯粹的阳历，并在1582年发展成格里历延续至今，即目前在使用的公历。\n南北朝时期数学家祖冲之在历法中引入了岁差，将朔望月长度定为29.5309日，将木星公转周期为11.858年（今测为11.862年），对农历进行了第二次改革。清朝汤若望（德国）推出《时宪历》，废除了圭表测影法，把全年分成二十四份，正式采用以太阳在黄道上位置为标准的定气，中国农历最后一次大改革结束并沿用至今。\n由于计算机在我国起步较晚，阴阳合历计算方式更为复杂，需要掌握历法、数学、天文学等多学科知识，许多人对中国农历阴阳合历复杂算法不甚了解，在很长一段时间里，多数研发工程师在计算中国农历时都是用“通用寿星公式”[Y*D+C]-L进行节气计算。“通用寿星公式”属于经验公式，实际上是通过寻找一个拟合值C，来不断趋近实际的农历二十四节气，在计算结果不正确时，又套用了“某某年需要加1日，某某年需要减1日”等“特殊情况”校正值，存在农历算法不准情况，且“通用寿星公式”只输出二十四节气内容有限，无法满足用户对农历更为丰富的文化需求。\n为符合Python解释型语言的本质，与跨平台脚本、快速开发应用的特性[2]，为传达精确计算及Python“胶水”语言的特性，让更多人方便使用，我们将设计一个依赖库少，农历算法清晰，二十四节气精准、功能丰富、基于Python的无数据库农历算法项目，并将其开源到Pypi（https://pypi.org/）上。\n\n\u003ch1\u003e二、需求分析\u003c/h1\u003e\n\n\u003ch2\u003e（一）二十四节气寿星公式存在问题\u003c/h2\u003e\n二十四节气寿星公式：[Y×D+C]-L。属于经验公式，其中Y取年数的后2位数，D取经验值0.2422，L取Y/4，公历2000年的小寒、大寒、立春、雨水按照20世纪的C值来算，具体C值如图2-1所示：\n\n图2-1 寿星公式查表值及特殊情况表\n\n根据以上情况，经过分析及实际使用，我们发现寿星公式看似公式简单，但实际判断逻辑复杂，在1901-2000年、2000年前四个节气、2000-2100年存在不同的算法值，200年内存在了22个不同年份的矫正值，在使用过程中极容易出错。经过行业调查发现，许多项目都使用了寿星公式进行二十四节气计算，在输出错误的节气日期后，转而影响到了农历阳历部分包括八字月柱表达、每日宜忌等数据的错误。为此，我们希望使用Python设计并实现一个精准清晰、功能多样化的农历综合算法程序，弥补行业内关于农历历法算法及宜忌算法的空白。\n\u003ch2\u003e（二）阴阳合历核心数据二十四节气数据计算方式\u003c/h2\u003e\n\n方案一，使用几何数学采用15%黄经夹角，计算日地椭圆轨道。在校验过数据与公式差异后，发现地球椭圆形轨道一年内公转速度差异超过7%，地球围绕著太阳作椭圆形公转，其自转轴并非垂直于公转面，而是倾斜约23度。从地球上观察，太阳相对遥远恒星的轨迹被称为“黄道”。概念上，节气是近乎均匀分布于“黄道”上24个位置的时刻。一个循环历时一年，更精确地说是一个“回归年”。[3]我们尝试使用平均值、开普勒第二定律计算行星轨道，计算值和香港天文台数据已经十分贴近了，但依然有差异。\n\n图2-2 椭圆形的地球公转轨道及二十四节气位置[3]\n\n差异主要来源于一下几个方面：（1）地球、月亮、太阳三个天体呈现无法完美预测的三体运动，甚至还包括木星引力影响（虽然引力抵消微弱）；（2）太阳本身也在运动，地球和太阳的质量也不是永恒不变的，这就导致地球的恒星年相对稳定，但回归年浮动振荡。\n方案二，直接使用香港紫金山天文台《公历农历对照表》。香港天文台提供的天文授时服务，整理1901年至2100年的观测和预测数据得出《公历农历对照表》。历法是严谨的天文科学，脱离了天文观测的历法将失去其科学性，横跨两个世纪的数据足够覆盖多数场景，在科学严谨性与实用性之间找到最佳平衡。\n为此，我们选择方案二作为定气数据。\n\n\u003ch2\u003e（三）设计一个即科学且富有文化传承的历法程序\u003c/h2\u003e\n\n中国传统历法中除“授时”等天文科学部分外，还有大量的“择日”相关社会科学内容。传统文化中设计了很多“神”，“神”的设计并不全是为了封建迷信，比如故人称木星为“岁”，但根据长久的天象观察，发现木星的公转周期并不是完整的12年（今测为11.862年），于是古人们为了节约历法的计算量，便虚拟出一颗与木星轨道相反，周期为十二年的暗星，称“太岁”，即岁神。\n中国传统社会有着丰富的社会活动，不同的社会活动赋予的文化含义不同，部分甚至相互对立，比如喜事与丧事。传统中国历法中设计了很多值班的“神”，不同“神”掌管不同的事务，合理地将这些事务归类，就避免邻里之间喜事丧事在同一天举行，极大地减少社会矛盾发生。然而，因社会活动复杂繁多，历法也设计出了极为复杂的算法，有的根据月份，有的根据日期，有的根据季节。\n在提供严谨科学的农历服务的同时，我们希望对中国农历的“文化部分”在代码中进行一定程度的传承。除提供历法科学部分外，根据《四库全书 - 钦定协纪辨方书》的内容，我们额外增加黄历传统文化内容转换等，考虑到使用者的便利性，又另外增加西方历法部分功能。\n综上，我们将功能解构为：\n\u003ch3\u003e1．历法部分：\u003c/h3\u003e\n公历农历转换（数字表达）、二十四节气日期、季节等；\n\u003ch3\u003e2．传统部分：\u003c/h3\u003e\n农历八字表达、每日宜忌、十二神、二十八星宿、纳音、七十二物候、时辰、星次、彭祖百忌、中医时辰经络、农历节日等；\n\u003ch3\u003e3．补充部分：\u003c/h3\u003e\n星座、公历节日、常见西方节日等。\n\n\u003ch2\u003e（四）设计一个容易使用的历法程序\u003c/h2\u003e\n\n2017年7月20日，国务院发布《新一代人工智能发展规划》，人工智能正式纳入国家发展战略，并且已经有数个省份将Python纳入到高考体系中。这说明，在未来很长一段时间内，会有越来越多学龄儿童使用到Python编程语言。为此我们应当设计一个能够轻易安装使用，没有额外附加环境条件的历法程序，我们希望它不包含SQL等数据库、不依赖第三方库只依赖Python基础库、可以使用“pip install”命令直接安装，包含一个用例让用户便捷使用。\n综上，我们得出如下设计方案：\n（1）将农历春节、闰月、二十四节气等数据使用十六进制存储、向量压缩保存在代码中；\n（2）仅用到Python基础库；\n（3）提供项目用例函数，且有默认值；\n（4）将项目发布到Pypi开源平台；\n（5）取一个简单容易记住的项目名称。\n\n\n\u003ch1\u003e三、系统设计\u003c/h1\u003e\n\u003ch2\u003e（一）农历项目命名\u003c/h2\u003e\n\n中国农历英文直译为“Chinese lunar calendar”，在Pypi上遍历不同名称组合及占用情况后，我们选择Python官方推荐的“驼峰命名法”，将我们的程序命名为：“cnLunar”。\n\u003ch2\u003e（二）目录结构设计\u003c/h2\u003e\n\n我们搭建了一个简易的框架结构来实现设计需求，如图3-1所示:\nconfig.py作为配置扩展使用，用于实现无数据库存放农历、二十四节气、星座等配置信息；\ndemo.py作为项目用例，在研发过程中用于调试，程序设计完成后用作帮助用户快速上手的代码模板；\nholidays.py用于存放公历、农历节日数据；\nlunar.py作为核心模块，用于支撑农历历法部分、传统部分、补充部分数据计算输出，并且保留大量《钦定协纪辨方书》原文作为注释，在输出出现差异时矫正结果；\nsolar24.py用于将200年内的二十四节气数据解压缩，为核心模块提供函数；\ntools.py用于存放基础的数据类型转换、数据清洗函数。\n\n\n图3-1 项目结构图\n\u003ch2\u003e（三）核心模块结构及算法设计\u003c/h2\u003e\n\n为减少开发者学习成本，我们将核心算法设计成一个类，对农历的所有数据转换只访问Lunar一个对象，对历法部分、常用传统部分数据在类初始化时生成，非常用传统部分数据、补充部分数据按需计算生成。这样，待项目发布后，用户只需要执行引入cnLunar，并调用Lunar对象初始化，就能在这个对象中获取到所有数据。\n\u003ch3\u003e1．每日神煞脚本结构设计\u003c/h3\u003e\n\n为满足传承中国历法的“传统部分”中复杂的历法算法和逻辑关系的需求，我们将根据《钦定协纪辨方书》原文，将“神煞”看做一个对象，设计一种与古文文字描述结构相匹配的脚本，以便支持快速将古文历法算法，快速翻译成Python语言的简易脚本结构。如图3-2。\n\n图3-2 《钦定协纪辨方书》影印版节选[4]\n\n在阅读《钦定协纪辨方书》原文大量章节后，我们总结出以下规律：\n（1）对象是有固定名称的；\n（2）一个对象是有值班时间的，值班时间和阳历、阴历年月日都有关系，多数对象习惯按月与日的关系排班；\n（3）书中的文字一般从正月开始排班，由于农历正月和农历正月八字表达方式“月柱”（农历八字表达方式的第三、四两字，以农历阳历二十四节气分割）有细微差异，农历正月并不完全等于八字正月；\n（4）一个对象是没有绝对好坏的，会在宜从事部分事情的同时，不宜从事部分事情；\n（5）不同的值班对象是有等级的，存在输出宜忌需要删减调整；\n（6）不同时代的宜忌翻译用词不太一样，需要矫正。\n根据对古文的抽象分析，我们设计如下脚本结构：\n```\n[(变量1：神煞名称，变量2：筛选条件，变量3：包含条件，变量4：命中后宜事集合，变量5：命中后忌事集合),……]\n```\n筛选规则尽量使用字符串或者有序列表合集，使用index指针取值，满足上述条件（3），支持传入指针值来源选择农历数字还是农历八字表达数字。执行规则为：判断变量2是否在变量3内。是，则变量1加入到今天的值神清单，变量4加入今日宜事清单，变量5加入今日忌事清单。否，下一步。\n比如《钦定协纪辨方书》原文中：“《广圣历》曰：‘岁破者，太岁所冲之辰也。其地不可兴造、移徙，嫁娶、远行，犯者主损财物及害家长，惟战伐向之吉。’”与“《广圣历》曰:‘岁德者，甲德在甲,乙德在庚,丙德在丙,丁德在壬,戊德在戊,己德在甲，庚德在庚,辛德在丙,壬德在壬,癸德在戊。’”[4]这两句可以转化为以下伪代码脚本：\n```\n[('岁破',{今日地支编号} == ({今年地支编号} + 6) % 12,[True],[],['兴造','移徙','嫁娶','远行']),\n('岁德','甲庚丙壬戊甲庚丙壬戊'[{今年天干编号}],{今日八字日柱},[],[])]\n```\n\u003ch3\u003e2．农历春节、闰月、二十四节气数据压缩\u003c/h3\u003e\n\n经过对香港天文台《公历与农历对照表》统计数据分析，如果对农历春节、闰月、二十四节气数据进行存储，可以节约计算量，为符合不引入数据库的设计需求，我们将设计二进制数据结构，存储到一个二进制文件中（调试时可以十六进制数的方式先存放于config.py配置结构）中，在需要使用时，使用位移运算符可高效地提取数据。\n\n图3-3香港天文台 - 公历与农历对照表 - 1901年[5]\n\n\u003ch4\u003e（1）春节数据\u003c/h4\u003e\n春节数据需要存储春节公历月和日数据，根据对1901-2100年春节日期变化数据统计，变化范围分别是1-3和1-31，对应二进制2位和5位，我们将月份数据放置于日期数据左侧，设计如下数据结构，1901年春节2月19日可存储为：\n```\n月份    日期\n010    10011\n```\n转化为两位十六进制为：0x53 。\n读取数据时，使用按位与运算符0x53 \u0026 0x1f，获取春节日期为19日，使用位移运算符、按位与运算符(0x53 \u003e\u003e 5) \u0026 0x3可得月份2月。\n\u003ch4\u003e（2）闰月及农历月份数据\u003c/h4\u003e\n\n运用同样的方法，我们可以将1901年农历全年月份大小月数据（小，大，小，小，大，小，大，小，大，大，大，大，小），以大月30天为1，小月29天为0，即可逆序表达为二进制011101010010。闰月月份变化范围为1-12，闰月和农历其他月份一样，也是有大小月区分，所以以1901年为例，全年数据可储存为：\n```\n闰月月份\t闰月大小月\t\t全年农历大小月（腊月.冬月.十月...正月）\n0000\t\t    0\t\t\t    011101010010\n```\n转化为十六进制为：0x752 。\n\u003ch4\u003e（3）二十四节气数据\u003c/h4\u003e\n\n二十四节气日期一共有四十八个数据，由于二十四节气是农历中阳历部分，划分后每个公历月份都会平均分到两个节气，我们就可以只保存日期数据，用数据在列表中的指针顺序整除以2再加1，即可求得月份。比如：1901年全年二十四节气只要保存为列表为：\n```\n[6,21, 4,19, 6,21, 5,21, 6,22, 6,22, 8,23, 8,24, 8,24, 9,24, 8,23, 8,22]\n```\n继承农历月份数据将小月大月天数[29，30]，转换成[0,1]二进制存储的数据压缩方式，经过对1901-2100年二十四节气数据分析，我们可求得一条最小公差向量：\n```\n[4,19, 3,18, 4,19, 4,19, 4,20, 4,20, 6,22, 6,22, 6,22, 7,22, 6,21, 6,21]\n```\n将全年二十四节气数据-最小公差向量可得：\n```\n[2,2,  1,1, 2,2, 1,2,  2,3,  2,2,  2,1,  2,2,  2,2,  2,2,  2,2  2,1]\n```\n可按月份逆序储存为二进制：\n```\n（12月.11月.10月...1月）\n0110  1010  1010  1010  1010  0110  1010  1010  1001  1010  0101 1010\n```\n转化为十六进制为：0x6aaaa6aa9a5a 。\n\n\n\u003ch1\u003e四、系统实现\u003c/h1\u003e\n\u003ch2\u003e（一）开发工具选择\u003c/h2\u003e\n我们选择PyCharm CE作为开发工具。PyCharm是最受欢迎的Python开发IDE（Integrated Development Environment，集成开发环境）之一，官方提供Windows、macOS、Linux不同系统版本及芯片支持，提供Professional专业版和Community社区版，其中社区版开源且免费。\n在IDE的帮助下，可以更方便地帮助我们在系统开发过程中提高效率、调试错误、保持规范化等。\n\u003ch2\u003e（二）面向对象开发\u003c/h2\u003e\n\n考虑到农历在不同场景下的不同应用，我们选择将核心模块作为一个强大的对象进行开发，方便后续开发者根据实际场景需要，选取自己所需的数据，或在进行二次开发时，直接继承该对象。\n我们将对象命名为Lunar，选用Python基础库datetime作为公历数据输入对象，提供一个额外参数godType，让使用者可以选择以农历月份，还是八字月柱确定宜忌，并提供默认值。具体结构如下：\n```\nfrom datetime import datetime\nclass Lunar:\ndef __init__(self, date=datetime.now(), godType='8char'):\n    \tself.godType = godType\n    \tself.date = date\n```\n我们希望用户在使用时，只需要引入我们的项目和Python基础库datetime，就可以根据需要，通过对象的方法和实例变量即可获取相应的数据：\n```\nimport datetime, cnlunar\na = cnlunar.Lunar(datetime.datetime(2022, 4, 7, 10, 30)\nprint(a.lunarYear, a.lunarMonth, a.lunarDay)\n```\n\u003ch2\u003e（三）命名规则\u003c/h2\u003e\n由于项目中含有大量的中国农历历法传统文化名称，而Python编码不像易语言一样支持中文作为变量名称，在“驼峰命名法”的基础上，我们要需要为项目定义一套便于理解的变量名称命名规则。\n有英文翻译的使用英文或英文缩写，一些特定名称暂时无法翻译的，使用拼音，比如纳音允许使用拼音nayin；\n对于名称包含数字的直接使用阿拉伯数字，如果数字位于开头则使用the，作为前缀，比如：Lunar().the28Stars代表二十八星宿；\n对于包含关联关系的，使用相同的前缀，比如：Lunar().goodGodName代表今日吉神，而Lunar().goodThing代表今日宜事；\n对有时间或前后关系的，使用today、next等作为前缀，比如：Lunar().todaySolarTerm代表查询今日节气，Lunar().nextSolarTerm代表下一个节气名称；\n对于输出数据与其他格式有显著不同，则在实例或方法后面添加输出类型后缀，比如：Lunar().thisYearSolarTermsDic代表获取今年全年二十四节气日期的字典。\n此外，在项目中我们对比较明确历法算法的使用get作为前缀，对于传统部分、补充部分中，一些可能涉及封建迷信部分，比如阴阳五行；或数据尚不完全，比如西洋节日等，我们暂时使用get_作为前缀，以期后续开发迭代中逐步完善。\n\u003ch2\u003e（四）项目仓库选择及开源模式选择\u003c/h2\u003e\n选择全球最大的开源平台Github.com作为代码仓库，使用Git对项目进行代码管理、项目分支管理，为后续系统测试提供灰测、众测用户获取渠道。\n选择GPL3.0协议作为开源协议，其核心是第三方若使用本项目进行二次开发，则不可闭源使用，新增的代码依然继承使用GPL3.0协议，即强制二次开发后依然需要开源。\n该项目选用Python作为主要开发语言，不同用户可以使用PHP、Java、C#.net等语言混合使用，但只要不变更项目内代码，则不用开源自己项目部分。选择GPL3.0协议可以在开源的同时，最大限度约束二次开发者帮助并共同优化原始项目。\n\u003ch2\u003e（五）无数据库农历算法实现\u003c/h2\u003e\n\u003ch3\u003e1．配置模块实现\u003c/h3\u003e\n在开发过程中，我们将一些常量从项目中逐步移出到配置文件config.py，并添加适当的注释描述。这样有助于项目代码的“解耦”，方便在开发过程中调试，对后续其他开发者在对项目二次开发时也较为友好。部分配置代码如下：\n\n```\nMONTH_DAY_BIT = 12\nLEAPMONTH_NUM_BIT = 13\n# 1901-2100年二十节气最小数序列 向量压缩法\nENC_VECTOR_LIST = [4,19,3,18,4,19,4,19,4,20,4,20,6,22,6,22,6,22,7,22,6,21,6,21]\n# 1901-2100年二十节气数据 每个元素的存储格式如下：\n# https://www.hko.gov.hk/sc/gts/time/conversion.htm\n# 香港天文台公布二十四节气按年存储16进制，1个16进制为4个2进制\nSOLAR_TERMS_DATA_LIST = [\n 0x6aaaa6aa9a5a,0xaaaaaabaaa6a,0xaaabbabbafaa,0x5aa665a65aab,0x6aaaa6aa9a5a, # 1901 ~ 1905\n0xaaaaaaaaaa6a,0xaaabbabbafaa,0x5aa665a65aab,0x6aaaa6aa9a5a,0xaaaaaaaaaa6a,\n]\n```\n\n在其他目录结构中，使用from cnlunar.config import *，来引入常量配置，比如在对农历闰月数据获取中，我们通过这样的代码组合实现读取压缩数据：\n```\nfrom cnlunar.config import *\ntmp = lunarMonthData[self.lunarYear - START_YEAR]\nleapMonth = (tmp \u003e\u003e LEAPMONTH_NUM_BIT) \u0026 0xf\n```\n\u003ch3\u003e2．核心模块实现\u003c/h3\u003e\n在开始开发核心模块历法部分功能后，我们使用之前设计的脚本结构，对《钦定协纪辨方书》卷九至卷十一关于每日宜忌部分的古文进行了大规模的逻辑算法翻译，最终使用超过700行代码、4万个字符的结构化脚本，还原古书中复杂的逻辑关系，完成了Lunar().get_AngelDemon()的开发，实现对《钦定协纪辨方书》中描述的农历每日宜忌规则进行了逻辑翻译。\n\n图4-1使用脚本结构翻译《钦定协纪辨方书》卷九至卷十一内容\n\n\n六、结论\n对比与寿星公式200年内二十四节气农历算法数据，我们的项目在准确性上有显著提升；对比其他项目，我们在环境配置上依赖极少，仅需Python环境，兼容Windows、macOS、Linux跨系统平台使用，在web平台、移动端平台参与了不同语言的混合开发，提升了兼容性；对比其他项目，我们仅需一条命令即可安装成功，提供demo.py用例，让用户更容易就能上手使用，提升了便利性；对比Github上其他农历项目，我们使用了《四库全书 - 钦定协纪辨方书》作为农历历法基础，提供了超过30个不同的农历算法，涵盖了历法部分、传统部分、补充部分多元化信息，提升了权威性和实用性。\n\n在设计和实现过程中，深刻地理解程序设计的重要性，通过合理的五段式脚本结构设计，极大地加快了翻译古文的效率。在设计之初就抛弃了数据库环境依赖，在后期众测、公测过程中，收获了使用不同数据库的开发者，使其不用改变已有项目环境即可参与。\n\n在开发工作开始前明确了命名规则，遵守开发规范，在后续扩展开发、开源过程中获得了极大便利。在实现过程中，充分理解底层数据存储结构，在使用二进制存储农历信息压缩大小月后，创新性地引入向量压缩法解决二十四节气存储及读取效率问题，夯实了计算机数据压缩基础。\n\n本人起初只是出于对二十四节气的好奇，发现国内不同的网站、应用给出的结果大不相同，进而引发了对寿星公式算法的质疑。在了解到中国农历是历史悠久的阴阳合历后，对中国历法历史进行了较为深度的探索。从古至今，中国农历吸引了海内外无数天文学家、数学家、文学家、社会学家参与编撰改革，堪称“文化瑰宝”。\n\n本文目前尚未完全翻译完整的《钦定协纪辨方书》内容，在一些晦涩传统文化理解有限并不一定准确，尚不能达到对传统文化的完整保留，期待后续有更大提升。\n\n\u003ch1\u003e参考文献\u003c/h1\u003e\n[1](日)薮内清（杜石然 译）. 中国的天文历法[M]. 北京大学出版社,2017.\n\n[2] python官方. Python 教程[EB/OL].https://docs.python.org/zh-cn/3.9/tutorial/index.html\n\n[3] 岑智明. 二十四节气[J/OL]. 香港联合国教科文之友,,2017,4月号第二期. http://friends.unesco.hk/en/2017Apr/zh/A4.html\n\n[4] (清)允禄 等. 四库全书 - 钦定协纪辨方书[M]. 世界知识出版社,2011-3\n\n[5]香港天文台.公历与农历对照表[OL],2020-2-10. https://www.hko.gov.hk/sc/gts/time/conversion.htm\n\n[6]Ben Straub. Pro Git(2nd Edition)[M/OL]. Apress,\n2014. https://git-scm.com/book/en/v2/Git-Tools-Submodules\n\n[7]白昌盛. Python编程特点及优势研究. 电子测试, 2020年第18期125-126\n\n[8]蔡彗连. 说风道水话“择日”. 中华建设, 2017年第1期44-45\n\n[9]于桂林. 二十四节气. 师范教育, 1991年第3期38-39\n\n[10]农历的编算和颁行.中华人民共和国国家标准[GB/T 33661-2017],http://www.pmo.cas.cn/xwdt2019/kpdt2019/202203/W020220324376886443533.pdf\n\n\u003ch1\u003e附录\u003c/h1\u003e\n\n根据《四库全书 - 协纪辨方书》添加了部分的吉神凶煞、八字，修正了部分八字月柱算法，关于值神方面的算法没有采用农历月算，而是根据农历八字月柱为依据，不同算法之间有细微区别。主要参考了老黄历、聚宝堂日历等，待持续优化\n铺注条例：\n凡铺注《万年历》、《通书》，先依用事次第察其所宜忌之日，于某日下注宜某事，某日下注忌某事，次按宜忌，较量其凶吉之轻重，以定去取。\n凡宜宣政事，布政事之日，只注宜宣政事。\n凡宜营建宫室、修宫室之日，只注宜营建宫室。\n\n凡吉足胜凶，从宜不从忌者，如遇德犹忌之事，则仍注忌。\n\n凡吉凶相抵，不注宜亦不注忌者，如遇德犹忌之事，则仍注忌。\n\n凡德合、赦愿、月恩、四相、时德等日，不注忌进人口、安床、经络、酝酿、开市、立券、交易、纳财、开仓库、出货财。如遇德犹忌，及从忌不从宜之日，则仍注忌。\n凡天狗寅日忌祭祀，不注宜求福、祈嗣。\n\n凡卯日忌穿井，不注宜开渠。壬日忌开渠，不注宜穿井。\n凡巳日忌出行，不注宜出师、遣使。\n凡酉日忌宴会，亦不注宜庆赐、赏贺。\n凡丁日忌剃头，亦不注宜整容。\n\n凡吉凶相抵，不注忌祈福，亦不注忌求嗣。\n\n凡忌诏命公卿、招贤，不注宜施恩、封拜、举正直、袭爵受封。\n凡忌施恩、封拜、举正直、袭爵受封，亦不注宜诏命公卿、招贤。\n凡宜宣政事之日遇往亡则改宣为布。\n凡月厌忌行幸、上官，不注宜颁诏、施恩封拜、诏命公卿、招贤、举正直。遇宜宣政事之日，则改宣为布。\n\n凡吉凶相抵，不注忌结婚姻，亦不注忌冠带、纳采问名、嫁娶、进人口，如遇德犹忌之日则仍注忌。\n凡吉凶相抵，不注忌嫁娶，亦不注忌冠带、结婚姻、纳采问名、进人口、搬移、安床，如遇德犹忌之日，则仍注忌。遇不将而不注忌嫁娶者，亦仍注忌。遇亥日、厌对、八专、四忌、四穷而仍注忌嫁娶者，只注所忌之事，其不忌者仍不注忌。\n凡吉凶相抵，不注忌搬移，亦不注忌安床。不注忌安床，亦不注忌搬移。如遇德犹忌之日，则仍注忌。\n凡吉凶相抵，不注忌解除，亦不注忌整容、剃头、整手足甲。如遇德犹忌之日，则仍注忌。\n凡吉凶相抵，不注忌修造动土、竖柱上梁，亦不注忌修宫室、缮城郭、筑提防、修仓库、鼓铸、苫盖、修置产室、开渠穿井、安碓硙、补垣塞穴、修饰垣墙、平治道涂、破屋坏垣。如遇德犹忌之日，则仍注忌。\n凡吉凶相抵，不注忌开市，亦不注忌立券、交易、纳财。不注忌纳财，亦不注忌开市、立券、交易。不注忌立券、交易，亦不注忌开市、纳财。\n凡吉凶相抵，不注忌开市、立券、交易，亦不注忌开仓库、出货财。如遇专忌之日，则仍注忌。\n凡吉凶相抵，不注忌牧养，亦不注忌纳畜。不注忌纳畜，亦不注忌牧养。\n凡吉凶相抵，有宜安葬不注忌启攒，有宜启攒不注忌安葬。\n\n凡土府、土符、地囊，只注忌补垣，亦不注宜塞穴。\n凡开日，不注宜破土、安葬、启攒，亦不注忌。遇忌则注。\n凡四忌、四穷只忌安葬。如遇鸣吠、鸣吠对亦不注宜破土、启攒。\n凡天吏、大时不以死败论者，遇四废、岁薄、逐阵仍以死败论。\n凡岁薄、逐阵日所宜事，照月厌所忌删去，所忌依然依从本日。\n\n凡二月甲戌、四月丙申、六月甲午、七月戊申、八月庚辰、九月辛卯、十月甲子、十二月甲子、德合与赦（天赦）、愿（天愿）所会之辰，诸事不忌。\n\n5、星次\n星纪、玄枵、娵訾、降娄、大梁、实沈、鹑首、鹑火、鹑尾、寿星、大火、析木\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopn48%2Fcnlunar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopn48%2Fcnlunar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopn48%2Fcnlunar/lists"}