工具用的順手嗎？
你的回饋能幫助我們做得更好
用於農曆與公曆日期互相轉換的工具，支援農曆閏月，適用於查詢節日、生辰或歷史日期。
Result will appear here
概覽
了解工具能解決的問題、計算或處理邏輯，以及資料邊界。
“公曆轉農曆”讀取一個 YYYY-MM-DD 日期，返回農曆年月日；“農曆轉公曆”讀取農曆年、月、日，並在該年確有閏月時把“普通月”和“閏月”列成兩個不同選項。轉換由專案中的 lunar-typescript 1.8.6 執行，輸入變化後自動更新，不需要另點轉換按鈕。
結果區的主日期會隨方向變化：前一種模式突出農曆，後一種模式突出公曆。附加資訊包括年干支與生肖的組合、月干支、日干支、星期索引；只有當天命中節氣或節日時，才顯示對應卡片。複製按鈕會把公曆、農曆、干支、星期以及存在的節氣和節日整理成多行文字。
同一農曆年中，普通二月與閏二月是先後兩個不同月份，對應的公曆日期不同。元件查詢所選農曆年的閏月，只在對應普通月後插入“閏某月”；傳給庫時，閏月用負月份值表示。因此，舊資料只寫“二月初一”卻未說明是否閏月時，無法唯一確定公曆日期。
農曆轉公曆的年份下拉框固定列出 1900–2099，共 200 個年份。公曆日期輸入框沒有在元件中宣告最小或最大日期，但這不等於所有歷史年代都經過頁面驗證。
指南
依步驟完成操作，並透過範例核對輸入與結果。
身份證、手機日曆常見的 2024-02-10 屬於公曆；“甲辰年正月初一”屬於農曆。頂部標籤應與已知日期一致。
公曆模式直接選擇日期。農曆模式依次選年、月、日；當月列表出現“閏某月”時，必須根據原始記錄判斷普通月還是閏月。
右側大字是轉換後的目標日期，次行保留另一套日期。再檢查干支、星期以及當天是否出現節氣或節日。
複製內容同時保留兩套日期與附加欄位，適合貼上到備忘錄。用於日程提醒時，應把轉換所得公曆日期寫入對應年份，而不是每年重複同一個公曆月日。
2023 年存在閏二月。選擇農曆 2023 年二月初一，當前庫轉換為公曆 2023-02-20；選擇 2023 年閏二月初一，轉換為 2023-03-22。兩者相差一個農曆月，說明“閏”字不能省略。
反向例子：輸入公曆 2024-02-10，頁面得到農曆“二〇二四年正月初一”，年干支與生肖組合爲“甲辰龍年”，節日欄位顯示“春節”，星期欄位顯示 6。這裏的 6 是元件直接展示的庫索引，不是中文“星期六”文字。
情境
查看這項工具在不同工作與生活流程中的用法。
按目標年份重新把農曆月日換為公曆，再寫入當年日曆；若出生記錄涉及閏月，應完整保留閏月資訊。
族譜、日記或歷史記錄採用農曆時，可逐條轉換並同時儲存原日期和結果，避免後續無法追溯轉換方向。
查某年春節、端午或中秋對應的公曆日期時，先選具體年份；同一農曆節日的公曆日期會隨年份變化。
問答
集中解答常見疑問與容易混淆的問題。
只有該農曆年確實設定閏月時，月份列表才插入對應項，而且閏月名稱跟在同名普通月之後。切換年份後，原先不再有效的閏月狀態會自動取消。
日期下拉框始終列出初一到三十，但農曆小月只有 29 天。若所選月份沒有第三十天，Lunar.fromYmd 會報錯，元件捕獲後把結果清空；應改選該月真實存在的日期。
當前頁面直接展示 getWeek() 的索引：0 代表星期日，1 到 6 代表星期一到星期六。複製文字也會保留這個數字。
不是。節氣與節日卡片只在返回字串非空時出現；普通日期仍會顯示兩套日期、干支和星期。節日集合合併了庫中的農曆節日、其他節日與公曆節日。
按鈕讀取瀏覽器當前時間，但公曆輸入值由 toISOString() 的 UTC 日期部分生成。UTC 日期與所在地日期不同的時段，輸入框可能相差一天，應以頁面顯示日期爲準並手動校正。
須知
使用前了解適用範圍、結果限制與必要提醒。
結果適合日常日期查詢，不應單獨作為歷史考證、法律文書、宗教歷日或精密天文歷算依據。
推薦
查找相關工具、專題與可用的 API 能力。
