农历是查出来的不是算出来的:一年一个十六进制数、朔日锚点与节气的平气近似
为什么农历没有换算公式
公历是纯粹的算术历:闰年规则一给,任何日期加减都是闭式计算。农历不行:农历月以朔日(新月发生的天文时刻)为界,月长 29 或 30 天取决于月球真实位置——朔是太阳、地球、月亮三体关系的观测结果,没有简洁的解析式。想精确算 2050 年的春节,要么跑天文历表(VSOP87/ELP2000 那类行星理论),要么——查表。
工程界的通行做法流传自经典的 calendar.js:一张覆盖 1900–2100 年的整数表,每年一个数,全站三个农历工具(🔧 农历日历转换 、🔧 农历生日提醒 、🔧 打印日历 )共用同源数据,锚点是农历 1900 年正月初一 = 公历 1900 年 1 月 31 日。
一年一个数:位压缩的艺术
每年那个十六进制数(如 2023 年的 0x05b52)是个位域结构:
| |
以 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° 过一个节气。太阳运动有非常稳定的天文周期,于是节气可以用平气近似公式算到分钟级:
| |
其中 31,556,925,974.7 毫秒即回归年 365.24219 天。这是「平均节气」的等间隔近似,与真实视太阳黄经相差最多一两分钟(地球公转的椭圆性带来的年内快慢被平均掉了)——对「今天是不是立春」级别的应用绰绰有余,历书级的精确节气仍需天文历。取结果日期时要按 UTC+8 口径取「日」——节气时刻落在哪个自然日与时区强相关,跨零点的节气在不同口径下会差一天,这是农历库最常见的 bug 来源之一。
生肖与干支反而最简单:生肖按农历年、(year − 4) mod 12 直接索引;干支 (year − 4) 分别 mod 10、mod 12 组合,六十甲子循环闭合——纯模算术,不需要任何表。
一张表撑起三个工具
农历这条线的工具共享同一张位表与同一套走表逻辑:农历转换做公历↔农历双向;农历生日提醒解决「农历生日每年公历不固定」的年度换算;打印日历把月历连同节气、农历、节日排成可打印的版面(打印口径的像素账在DPI 的真相里算过)。日历打印与办事文档这组,收在打印模板台专题里,全部本地计算,离线可用。