歷史學和漢文學中的"三抄七改":
一小時的差錯，整個時代改變
如果你只是使用購買的"萬年曆"或者在隨機的風水網站上查詢，很可能你的錯誤差距達到一整個月。
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/胡玉德算法和確定性數學公式——不猜測、不幻覺。