日历，作为人类记录时间流逝的工具，其背后蕴含着精密的天文学观测与复杂的数学算法。无论是我们日常使用的公历（格里高利历），还是承载着深厚文化底蕴的中国农历（阴阳合历），其每一天的设定都不是随意的，而是基于地球自转、公转以及月球绕地运行周期的精确计算。对于程序员、历史研究者以及易学爱好者而言，掌握日历计算公式不仅是理解时间维度的钥匙，更是开发相关应用、考证历史日期的核心技能。
本文将深入探讨公历转农历、农历转公历的核心算法，解析干支纪年的数学模型，并介绍儒略日（Julian Day）这一在天文学中至关重要的时间转换标准。我们将通过详细的公式推导、代码示例以及历史背景，为您呈现一个全面而深度的日历算法知识体系。
公历是目前国际通用的历法，其核心在于尽可能准确地匹配地球的回归年（Tropical Year，约365.2422天）。为了弥补0.2422天的差距，公历引入了闰年机制。
判断一个年份是否为闰年，遵循以下逻辑规则：
用伪代码表示即为：(year % 4 == 0 && year % 100 != 0) || (year % 400 == 0)。
公历一年有12个月，其中7个大月（31天），4个小月（30天），2月平年28天，闰年29天。为了便于计算，通常使用一个数组来存储每个月的天数：
int daysInMonth[] = {0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};
// 注意：索引0通常置0或作为填充，索引1对应1月，以此类推。
// 若为闰年，daysInMonth[2] 需调整为 29。
儒略日是从公元前4713年1月1日中午开始计算的天数，是天文学中用于连续计数的标准。将公历日期转换为儒略日的公式较为复杂，涉及多个修正项：
function toJulianDay(year, month, day) {
if (month <= 2) {
year -= 1;
month += 12;
}
let A = Math.floor(year / 100);
let B = 2 - A + Math.floor(A / 4);
return Math.floor(365.25 (year + 4716)) + Math.floor(30.6001 (month + 1)) + day + B - 1524.5;
}
这一公式确保了不同历史时期的日期可以在同一个连续的时间轴上进行比较和计算，是进行日历转换的重要基础。
农历是中国传统的阴阳合历，它既考虑了月相变化（朔望月，约29.5306天），又考虑了太阳回归年（约365.2422天）。这种双重标准使得农历的计算远比公历复杂。
农历以朔（月亮位于太阳和地球之间，完全不可见）定初一。由于朔望月平均长度约为29.53天，因此农历月份分为大月（30天）和小月（29天）。哪个月是大月，哪个月是小月，取决于两个朔日之间的实际天数。
这是农历算法中最核心的部分。农历一年通常有12个月，约354天，比回归年少11天左右。为了保持季节与月份的对应关系，必须设置闰月。
农历将二十四节气分为“节气”和“中气”，交替出现。如果某个月份中只包含一个节气而不包含中气，则该月被定为上一个月的闰月。例如，如果某月只有“清明”而无“谷雨”，则该月为闰三月。
这是一个经验性的周期规律。经过19个回归年（约6939.6天）与19个农历年的总天数非常接近。因此，农历采用“19年7闰”的方法，即在19年中插入7个闰月，以协调阴历和阳历的时差。
在历法推算中，冬至是一个关键的参考点。农历规定，包含冬至的那个月为十一月（子月）。从十一月开始，依次序数为十二月、正月、二月……以此类推。这一规则确保了农历月份与太阳位置的相对稳定性。
| 节气类型 | 节气名称 | 中气名称 | 意义 |
|---|---|---|---|
| 单 | 立春 | 雨水 | 春季开始，雨水渐多 |
| 单 | 惊蛰 | 春分 | 春雷始鸣，昼夜平分 |
| 单 | 清明 | 谷雨 | 气清景明，雨水滋润 |
| 单 | 立夏 | 小满 | 夏季开始，作物渐满 |
| 单 | 芒种 | 夏至 | 麦类有芒作物成熟，昼最长 |
| 单 | 小暑 | 大暑 | 炎热季节，一年最热 |
| 单 | 立秋 | 处暑 | 秋季开始，暑气渐消 |
| 单 | 白露 | 秋分 | 露水凝结，昼夜平分 |
| 单 | 寒露 | 霜降 | 露水寒冷，初霜出现 |
| 单 | 立冬 | 小雪 | 冬季开始，初雪降临 |
| 单 | 大雪 | 冬至 | 雪量大，昼最短 |
| 单 | 小寒 | 大寒 | 寒冷至极，一年最冷 |
干支纪年是中国古代历法的重要组成部分，由十个天干（甲、乙、丙、丁、戊、己、庚、辛、壬、癸）和十二个地支（子、丑、寅、卯、辰、巳、午、未、申、酉、戌、亥）依次组合，形成60年一个循环的“六十甲子”。
天干与公历年份的尾数存在固定对应关系：
| 年份尾数 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
|---|---|---|---|---|---|---|---|---|---|---|
| 天干 | 庚 | 辛 | 壬 | 癸 | 甲 | 乙 | 丙 | 丁 | 戊 | 己 |
通用公式：天干序号 = (年份 - 3) % 10。若结果为0，则对应第10位“癸”。
地支与公历年份的关系如下：
通用公式：地支序号 = (年份 - 3) % 12。若结果为0，则对应第12位“亥”。
| 余数 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 0 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 地支 | 子 | 丑 | 寅 | 卯 | 辰 | 巳 | 午 | 未 | 申 | 酉 | 戌 | 亥 |
罗马共和国独裁官儒略·凯撒采纳埃及亚历山大的希腊数学家兼天文学家索西琴尼的计算，改革历法，颁布儒略历。这是公历的前身。
中国汉武帝时期颁布《太初历》，正式将二十四节气纳入历法，确立了以无中气之月为闰月的规则，奠定了后世农历的基础。
教皇格里高利十三世颁布格里高利历，修正了儒略历的累积误差，确立了现行的闰年规则。
法国学者Joseph Scaliger和比利时学者Petrus Peiresc等学者完善儒略日概念，使其成为天文学中统一的时间坐标。
随着计算机技术的发展，日历算法被广泛应用于软件开发、金融结算、农业生产等领域。开源社区涌现出大量高精度的农历和干支计算库。
农历是阴阳合历，为了协调回归年（太阳年）和朔望月（月亮月）之间的时间差，采用“十九年七闰”的方法。具体算法是：如果某个月份中没有“中气”（二十四节气中的双数节气，如雨水、春分等），则该月定为闰月，称为“闰X月”。例如，2020年农历四月后有一个闰四月。
公历闰年是为了弥补因人为历法规定造成的年度天数与地球实际公转周期的时间差，通过增加2月29日来调整，周期为4年。农历闰月则是为了协调朔望月与回归年的差异，通过增加一个完整的月份（如闰五月）来调整，周期约为19年。两者目的相同，但手段不同。
天干算法：年份尾数对应甲(4)、乙(5)...癸(3)。地支算法：(年份-3)除以12的余数对应子(1)、丑(2)...亥(12)。例如2024年，尾数4为甲，(2024-3)%12=1... 修正：2024-3=2021, 2021%12=5, 5对应辰。故为甲辰年。
春节是农历正月初一。由于农历是阴阳合历，其月份基于月相，年份基于回归年，与公历（纯阳历）的对应关系每年都在变化。因此，春节的公历日期通常在1月21日至2月20日之间波动。
儒略日提供了一个连续的天数计数系统，避免了不同历法（如公历、农历）在月份长度、闰年规则上的复杂性。在天文学中，计算两个日期之间的时间间隔、预测天体位置时，使用儒略日可以大大简化计算过程。
通过对公历、农历及干支历法的深入解析，我们可以看到，日历不仅仅是记录日期的工具，更是人类智慧与自然规律结合的结晶。掌握这些日历计算公式，不仅有助于我们在技术层面实现时间的精确转换，更能让我们深刻理解中华文化中蕴含的天文历法智慧。希望本文能为您的研究和工作提供有价值的参考。