朋友小聚，聊到「劳动节农历日期」，桌上四个人四个说法。我回家翻了翻官方文件，才发现这事儿其实早有明确规定，只是网上以讹传讹。
从常见场景说起
农历是阴阳合历：月按月相(朔望月29.53天)，年按回归年(365.24天)，用闰月补差(19年7闰)。农历转换要查1900-2100年的农历数据表(每年含闰月、大小月、节气信息)，算法复杂通常用库。时区影响日期计算，跨时区场景统一用UTC存储显示时转本地。跨年跨月的计算最容易出错，用日期库能避免大部分坑。
另一种场景
二十四节气按太阳黄经划分(每15度一个)，立春315度、春分0度、夏至90度、冬至270度。节气对应公历日期基本固定(前后差1-2天)，因为按太阳。生肖、传统节日(春节元宵端午中秋)都按农历。用在线工具算比手算可靠，工具内置了完整的数据表和边界处理。闰年判断口诀：四年一闰、百年不闰、四百年再闰。
不管哪种情况，这几点都成立
先搞清算法。劳动节农历日期这类生活计算，本质是日期或时间的加减。难点不在算术，而在边界情况：闰年、闰月、节假日、农历公历转换，这些搞错结果就错。时间戳是绝对时间不受时区影响，转本地时间要加时区偏移。日期计算别用"每月30天"这种近似，实际28到31天不等，会算错。
几个要注意的地方
下面这几条比正文还重要，别跳过：
- 农历是阴阳合历：月按月相29.53天，年按回归年365.24天，用闰月补差
- 19年7闰，闰月加在哪个月按节气计算规则定
- 二十四节气按太阳黄经划分(每15度一个)，公历日期基本固定
- 算法复杂通常用库，自己实现容易出错
其实「劳动节农历日期」就这点事儿，原理懂了，剩下就是多练几遍。有什么没讲透的，欢迎留言接着聊。
跨年跨月的计算最容易出错，用日期库能避免大部分坑。工作日计算要查当年的放假安排表，不能简单乘5/7。日期计算别用"每月30天"这种近似，实际28到31天不等，会算错。单次算错通常是边界没处理：闰年、跨月、节假日、时区。日期加减用专门的库或时间戳，手算容易漏闰年漏跨月。农历和公历的对应每年都变，去年的数据今年不能直接用。闰年判断口诀：四年一闰、百年不闰、四百年再闰。时区影响日期计算，跨时区场景统一用UTC存储显示时转本地。
常见问题
【二十四节气怎么来的？】按太阳黄经划分，每15度一个节气，立春315度春分0度夏至90度冬至270度。节气对应公历日期基本固定(前后差1-2天)，因为按太阳运行，和农历月份无关。
【农历为什么有闰月？】农历月按月相29.53天，12个月约354天，比回归年(365.24天)少11天。用闰月补差(19年7闰)，否则农历年和季节会逐渐错位。闰月加在哪个月按节气计算规则定。
【农历和阳历怎么转换？】农历是阴阳合历(月按月相年按太阳，用闰月补差)，转换要查1900-2100年农历数据表。算法复杂通常用库或在线工具，输入一个日期自动算另一个，还带节气生肖。
【劳动节农历日期怎么算？】本质是日期时间加减，用日期库或时间戳算最准。难点是闰年闰月节假日农历等边界情况，用在线工具输入日期直接出结果最省事，不用记公式。
