历史学和汉文学中的"三抄七改":
一小时的差错，整个时代改变
如果你只是使用购买的"万年历"或者在随机的风水网站上查询，很可能你的错误差距达到一整个月。
1. 时区的陷阱：GMT+7 和 GMT+8
查询历史日期的最大错误是默认越南农历和中国农历相同。
实际上，由于越南（东经105°）和中国（东经120°）相差1小时，朔节点（农历月份开始的时刻）经常落在两个不同的日期。
越南春节比中国早整整1个月。
后果：如果你在研究这个时期的材料，并使用中国日期转换工具来转换越南发生的事件日期，你的所有历史数据都会完全错误。
• 越南：丙戌年六月初一
• 中国：丙戌年五月三十
→ 相差1天，因为朔节点发生在越南时间23:05
技术分析：为什么越南和中国不同？
| 🇻🇳 越南 (GMT+7) | 🇨🇳 中国 (GMT+8) | |
|---|---|---|
| 前月朔节点 (k) | 2006年5月27日 | 2006年5月27日 |
| 后月朔节点 (k+1) | 2006年6月25日 | 2006年6月26日 |
| 月份开始 | 6月25日（六月） | 5月27日（仍在五月） |
| 农历结果 | 六月初一 | 五月三十 |
2006年6月26日 00:00-01:00 UTC。- GMT+7 (越南)： 上午 07:00-08:00 6月25日 → 新月份从6月25日开始
- GMT+8 (中国)： 上午 08:00-09:00 6月26日 → 新月份从6月26日开始
👉 我们的工具解决了这个问题：通过分别为越南和中国时区的计算算法，我们为历史事实恢复了真实。
2. 节气与汉文学的微妙之处
在汉文学中，"节气"不仅仅是天气，它是灵感。
当李白写月亮，或者阮攸写草木时，他们生活在一个特定的节气空间中（立春、雨水、清明...）。
- 普通工具只按平均日期计算节气（误差大）
- 精准农历工具：使用VSOP87算法实时计算太阳黄经
- 你将精确知道节气转换到每一分钟
这帮助学者深刻理解作者为什么在那个特定的天文背景下使用这些词语。古典文学与天文学是分不开的！
3. 天干地支与四柱：破译古文献的钥匙
确定"甲子"日、"丙寅"时对于对照古文献（确定石碑年代、诏令）至关重要。
许多现有工具计算错误天干时柱（只按机械表格计算）。
我们的工具应用道教算法精确计算天干时柱：
例子：日柱为乙巳(干=1)，时支为子(支=0)
→ 时干 = (1×2 + 0) mod 10 = 2 → 丙子
对四柱或理数研究的有力支持。
4. 验证的可靠性：108个测试用例 ✓
不像那些迷信的"黄历应用"，这是一个科学工具，配备了完整的自动化测试套件：
1. 标准春节日期（黄金参考）
- 2024年春节：02月10日 → 甲辰年正月初一 ✓
- 2025年春节：01月29日 → 乙巳年正月初一 ✓
- 2026年春节：02月17日 → 丙午年正月初一 ✓
- 戊申年春节1968年：01月29日 ✓
- 1980年、2012年、2020年春节... ✓
2. 越南与中国差异
- 2006年6月25日：越南 = 初六，中国 = 五月三十 ✓
- 自动检测朔差异原因 ✓
3. 越南生肖（猫 vs 兔）
- 2023年：越南 = 猫，中国 = 兔 ✓
- 1963年、1975年、1987年、1999年、2011年... ✓
4. 冬至
- 12月21-22日跨越多个世纪：1950年、2000年、2024年、2025年 ✓
5. 节气开始点
- 立春（2月3-5日）：2024年、2025年、2026年 ✓
- 春分（3月20-21日）：2024年、2025年 ✓
6. 闰月
- 2020年：有闰月（四月） ✓
- 2023年：有闰月（二月） ✓
- 2025年：有闰月 ✓
7. 历史范围（1850-2100）
- 1850年、1900年、1950年、2000年、2050年、2100年 ✓
8. Delta T（时间差）
- 1900年：约-3秒，1950年：约29秒，2000年：约64秒，2020年：约69秒 ✓
9. 天干地支精确度
- 2024年 = 甲辰，2025年 = 乙巳，2026年 = 丙午 ✓
- 1984年 = 甲子，2000年 = 庚辰 ✓
10. 越南历史时区
- 1954-1967年北方：实际UTC+8（中国天文表） ✓
- 1968年后北方：UTC+7（121-CP决定） ✓
- 1960-1975年南方：UTC+8（362-TTP法令） ✓
- 1975年后：统一 UTC+7 ✓
11. 高级节气API
- 2026年2月4日 = 立春（开始） ✓
- 精确到分钟计算 ✓
12. 越南/中国对比调试
- 自动检测根本原因 ✓
- 解释差异原因 ✓
- 精确：基于NASAJean Meeus胡翼中的天文模型
- 透明：明确指出越南历和中国历的差异，允许直接比较
- 深度数据：支持回溯查询遥远过去（1800-2200年）– 纸质历无法做到
- 开源逻辑：透明算法，可由科学社区验证
5. 2026升级：真太阳时与历史时区
Quizzman农历转换工具的最新版本提供前所未有的深度功能：
真太阳时（True Solar Time）
时钟时间（河内，GMT+7）是平均时间。实际上，太阳经过天顶（午时）的时间比时钟晚约7分钟（河内），比时钟早约4分钟（胡志明市）。该工具根据经度和均时方程精确计算这个差异。
越南历史时区（1906-1975）
支持60多个越南城市的精确时区，按时期：1906年前（本地太阳时），1906-1942年（UTC+7），1943-1945年（日本时期UTC+8/+9），1947-1954年（法国UTC+8），1975年后（统一UTC+7）。
v2.1新增：1954-1967年间，北越虽名义上使用UTC+7，但历法实际采用中国紫金山天文台（UTC+8）数据。121-CP决定（1967年）结束了这一状况，直接导致了1968年戊申春节南北差异。
节气月（Solar Month）
为风水师量身定制：根据节气（例如：过了立春才算进入寅月）显示月份的天干地支，与民用农历月份完全分离。
夜子 / 正子选项
解决千年争议：子时（23点-01点）属于今天（夜子）还是明天（正子）？你可以选择自己的学派。
八字与紫微整合
该日期工具是八字（四柱）和紫微斗数工具的基础，确保基于精确时区和标准农历日期的命盘准确性。
谁应该使用这个工具?
- 汉文学研究者：精确确定古文献年代
- 历史学家：对照历史事件与精确农历
- 文史专业学生：理解古典文学中的天文背景
- 汉文翻译者：掌握诗歌中节气语境的微妙之处
- 东亚文化爱好者：探索越南-中国历法的差异
精度验证：当AI给出错误的测试用例，引擎依然正确
在质量验证过程中，我们使用 Google Gemini 生成了12个边缘测试用例，旨在以最困难的场景挑战引擎：越中朔日分歧、真太阳时、节气、夜子/正子时，以及闰月。
结果：12个用例中有7个初始FAIL。然而，在逐一使用天文公式调试并从J2000.0纪元验证JDN（儒略日数）后，全部7个失败均由 Gemini给出的错误预期 导致，而非引擎缺陷。
- 1968年：Gemini选错了阳历日期（2月16日而非1月29日）——引擎正确计算了戊申年正月朔日
- 1972年：Gemini声称越中存在分歧——全年扫描确认零分歧
- 1984年：Gemini混淆了春节日期（2月2日）与分歧起始——实际分歧始于1984年11月23日
- 真太阳时（胡志明市）：Gemini使用110°E作为标准子午线——正确值为105°E（UTC+7 = 7×15°）
- 2026年3月24-25日日柱：Gemini给出错误地支（巳/午）——JDN验证得出酉/戌
• 31/31 边缘用例 PASS（扩展基准测试：历史时区 & VSOP87）
• 108/108 回归用例 PASS（原有测试完全不受影响）
• 共计 139/139 测试用例 PASS——引擎完全准确
这证明了即使是像Gemini这样先进的AI系统也可能产生错误的天文数据，而我们的引擎基于Jean Meeus/胡玉德算法和确定性数学公式——不猜测、不幻觉。