有人私信问我「端午节农历日期」，我让他先把具体场景说清楚。他回了一长串，我看完了发现：他真正卡住的点，跟他以为的完全不是一回事。
先把基本概念理清
农历是阴阳合历：月按月相(朔望月29.53天)，年按回归年(365.24天)，用闰月补差(19年7闰)。农历转换要查1900-2100年的农历数据表(每年含闰月、大小月、节气信息)，算法复杂通常用库。工作日计算要查当年的放假安排表，不能简单乘5/7。时间戳是绝对时间不受时区影响，转本地时间要加时区偏移。
关键细节
二十四节气按太阳黄经划分(每15度一个)，立春315度、春分0度、夏至90度、冬至270度。节气对应公历日期基本固定(前后差1-2天)，因为按太阳。生肖、传统节日(春节元宵端午中秋)都按农历。农历转换要查数据表，没有简单公式，因为闰月大小月每年不同。日期相关的计算，"起始日"和"结束日"含不含当天要先约定清楚。
落到实际场景
先搞清算法。端午节农历日期这类生活计算，本质是日期或时间的加减。难点不在算术，而在边界情况：闰年、闰月、节假日、农历公历转换，这些搞错结果就错。农历和公历的对应每年都变，去年的数据今年不能直接用。日期加减用专门的库或时间戳，手算容易漏闰年漏跨月。
最后补充几点
再说精度。日期计算要用专门的日期库或时间戳，别用"每月30天"这种近似(实际28-31天不等)。农历转换更要查数据表，因为农历闰月、大小月每年不同没有简单公式。跨年跨月的计算最容易出错，用日期库能避免大部分坑。时区影响日期计算，跨时区场景统一用UTC存储显示时转本地。
几个要注意的地方
为了避免算完发现对不上，请注意：
- 农历是阴阳合历：月按月相29.53天，年按回归年365.24天，用闰月补差
- 19年7闰，闰月加在哪个月按节气计算规则定
- 二十四节气按太阳黄经划分(每15度一个)，公历日期基本固定
- 算法复杂通常用库，自己实现容易出错
今天讲的这些，你自己跑一遍流程，比我再说十遍都管用。开始吧。
闰年判断口诀：四年一闰、百年不闰、四百年再闰。日期加减用专门的库或时间戳，手算容易漏闰年漏跨月。时区影响日期计算，跨时区场景统一用UTC存储显示时转本地。日期相关的计算，"起始日"和"结束日"含不含当天要先约定清楚。农历转换要查数据表，没有简单公式，因为闰月大小月每年不同。农历和公历的对应每年都变，去年的数据今年不能直接用。
常见问题
【端午节农历日期怎么算？】本质是日期时间加减，用日期库或时间戳算最准。难点是闰年闰月节假日农历等边界情况，用在线工具输入日期直接出结果最省事，不用记公式。
【农历为什么有闰月？】农历月按月相29.53天，12个月约354天，比回归年(365.24天)少11天。用闰月补差(19年7闰)，否则农历年和季节会逐渐错位。闰月加在哪个月按节气计算规则定。
【二十四节气怎么来的？】按太阳黄经划分，每15度一个节气，立春315度春分0度夏至90度冬至270度。节气对应公历日期基本固定(前后差1-2天)，因为按太阳运行，和农历月份无关。
【农历和阳历怎么转换？】农历是阴阳合历(月按月相年按太阳，用闰月补差)，转换要查1900-2100年农历数据表。算法复杂通常用库或在线工具，输入一个日期自动算另一个，还带节气生肖。
