Ganzhi Calendar (干支计算)

Calculate Chinese lunar calendar dates with Heavenly Stems (天干) and Earthly Branches (地支). Use when generating Chinese calendar tables, checking 黄历, or conve...

安装

概览

什么是Ganzhi Calendar (干支计算)

干支日历(Ganzhi Calendar)是一款专门用于计算中国传统农历日期与天干地支对应关系的工具。它以1983年2月5日为基准日(甲子日),通过数学算法精确推算任意日期的天干地支组合,涵盖年月日的完整干支系统。该工具不仅支持公历到农历的转换,还能输出每日的干支信息,包括年柱、月柱和日柱的完整表达。其核心优势在于算法严谨、数据校准准确,适用于需要高精度传统历法计算的场景。通过简单的脚本调用,即可生成包含农历日期、星期、生肖及干支信息的日历表格,极大提升了传统历法查询的效率。

核心功能特点

  1. 基于1983年2月5日甲子日的精确算法,支持任意日期的天干地支推算
  2. 自动计算年、月、日三柱干支,并关联对应的十二生肖
  3. 可生成结构化的周历或月历表格,包含农历日期与传统干支信息
  4. 使用Python编写,代码开源透明,便于二次开发与集成

适用场景

干支日历特别适合对中华传统历法有深度需求的用户群体。在民俗应用中,它可用于生成黄历参考表,帮助使用者快速查阅每日的干支吉凶、宜忌事项,尤其在择日、婚嫁、动土等传统文化活动中具有重要价值。对于历史研究者而言,该工具能辅助还原特定历史事件发生的干支背景,增强文献解读的时空准确性。此外,在编程开发中,若需将传统历法与公历系统结合,此工具提供的算法可直接复用,避免重复造轮子。无论是个人日常查用还是项目开发,干支日历都提供了一种高效、可靠的解决方案。