为什么农历没有换算公式

公历是纯粹的算术历:闰年规则一给,任何日期加减都是闭式计算。农历不行:农历月以朔日(新月发生的天文时刻)为界,月长 29 或 30 天取决于月球真实位置——朔是太阳、地球、月亮三体关系的观测结果,没有简洁的解析式。想精确算 2050 年的春节,要么跑天文历表(VSOP87/ELP2000 那类行星理论),要么——查表。

工程界的通行做法流传自经典的 calendar.js:一张覆盖 1900–2100 年的整数表,每年一个数,全站三个农历工具(🔧 农历日历转换 、🔧 农历生日提醒 、🔧 打印日历 )共用同源数据,锚点是农历 1900 年正月初一 = 公历 1900 年 1 月 31 日。

一年一个数:位压缩的艺术

每年那个十六进制数(如 2023 年的 0x05b52)是个位域结构:

1
2
3
bit 0–3    :闰月月份(0 = 当年无闰月)
bit 4–15   :正月至腊月的大小月(1 位/月:1 = 30 天大月,0 = 29 天小月)
bit 16     :闰月是大月还是小月

以 2023 年的 0x05b52 验算:二进制 0101 1011 0101 0010,低 4 位 0010 = 2——2023 年闰二月(与实际相符);第 17 位为 0,闰二月是小月 29 天。

201 行数据就把两个世纪的月历装下了——平均每年 17 个有效位,比存 JSON 明细紧凑一个数量级。转换算法是标准的「走表累加」:公历日期先算出距 1900-01-31 的天数,然后从锚点起逐年减去农历年长(12 或 13 个月的天数和,闰月按位域展开)、再逐月减去月长,落在哪个月哪一天,就是农历几月几日——余数走完全表即结果,闰月标记随位域自然浮现。反向(农历转公历)对称:从锚点累加到目标年月,加上日偏移。表外(1900 前/2100 后)直接判越界而不是外推——农历没有可外推的周期性,硬算必错。

节气:可以「算」的那一半

二十四节气跟农历月不同源——节气属太阳历:把黄道 24 等分,太阳每走 15° 过一个节气。太阳运动有非常稳定的天文周期,于是节气可以用平气近似公式算到分钟级:

1
2
3
第 n 个节气的时刻 ≈ 1900-01-06 02:05 UTC
                  + n × 回归年/24
                  + (y − 1900) × 31556925974.7 ms

其中 31,556,925,974.7 毫秒即回归年 365.24219 天。这是「平均节气」的等间隔近似,与真实视太阳黄经相差最多一两分钟(地球公转的椭圆性带来的年内快慢被平均掉了)——对「今天是不是立春」级别的应用绰绰有余,历书级的精确节气仍需天文历。取结果日期时要按 UTC+8 口径取「日」——节气时刻落在哪个自然日与时区强相关,跨零点的节气在不同口径下会差一天,这是农历库最常见的 bug 来源之一。

生肖与干支反而最简单:生肖按农历年、(year − 4) mod 12 直接索引;干支 (year − 4) 分别 mod 10、mod 12 组合,六十甲子循环闭合——纯模算术,不需要任何表。

一张表撑起三个工具

农历这条线的工具共享同一张位表与同一套走表逻辑:农历转换做公历↔农历双向;农历生日提醒解决「农历生日每年公历不固定」的年度换算;打印日历把月历连同节气、农历、节日排成可打印的版面(打印口径的像素账在DPI 的真相里算过)。日历打印与办事文档这组,收在打印模板台专题里,全部本地计算,离线可用。