「清明农历日期」最坑的地方在于：你以为自己懂了，一动手就发现哪儿都不对。这篇就是写给那种"看了很多还是不会算"的人。
从常见场景说起
农历是阴阳合历：月按月相(朔望月29.53天)，年按回归年(365.24天)，用闰月补差(19年7闰)。农历转换要查1900-2100年的农历数据表(每年含闰月、大小月、节气信息)，算法复杂通常用库。跨年跨月的计算最容易出错，用日期库能避免大部分坑。农历转换要查数据表，没有简单公式，因为闰月大小月每年不同。
再来看个不一样的
二十四节气按太阳黄经划分(每15度一个)，立春315度、春分0度、夏至90度、冬至270度。节气对应公历日期基本固定(前后差1-2天)，因为按太阳。生肖、传统节日(春节元宵端午中秋)都按农历。闰年判断口诀：四年一闰、百年不闰、四百年再闰。农历和公历的对应每年都变，去年的数据今年不能直接用。
通用建议
先搞清算法。清明农历日期这类生活计算，本质是日期或时间的加减。难点不在算术，而在边界情况：闰年、闰月、节假日、农历公历转换，这些搞错结果就错。时间戳是绝对时间不受时区影响，转本地时间要加时区偏移。时区影响日期计算，跨时区场景统一用UTC存储显示时转本地。
几个要注意的地方
操作之前，这几件事你得心里有数：
- 农历是阴阳合历：月按月相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年农历数据表。算法复杂通常用库或在线工具，输入一个日期自动算另一个，还带节气生肖。
