日期差計算器

相差天數是五項結果的共同基準

選擇兩個日期後，頁面先求它們之間的絕對時間距離，所以開始日期早於或晚於結束日期都得到同一個非負結果。最大的數字是相差天數；下方的年、月、周、小時不是一段“幾年幾個月幾天”的拆分，而是把同一段距離分別換成五種總量後取整數。

floor 表示只保留已經完成的整數單位，不做四捨五入。日期輸入不含時分秒，因此正常有效日期的小時結果等於相差天數乘以 24。每張結果卡片都可單獨複製當前數字。

月數和年數屬於平均長度估算

公曆月份可能有 28、29、30 或 31 天，自然年也可能有 365 或 366 天；頁面沒有按日曆逐月借位，而是固定用 30.44 日估算一個月、365.25 日估算一年，再向下取整。這種口徑適合把較長的總天數粗略換成完整月數或年數，卻不能回答“滿幾個自然月”或“到了第幾個週年日”。

結果項	頁面口徑	適合怎樣讀
天	兩個日期的絕對間隔	作為主要、可直接覈對的跨度
周	總天數 ÷ 7 後取整	已經完成的整週數量
月	總天數 ÷ 30.44 後取整	按平均月長得到的近似整月數
年	總天數 ÷ 365.25 後取整	按固定平均年長得到的近似整年數
小時	日期間隔換成整小時	日期級跨度的 24 倍表達

美國海軍天文臺給出的公曆長期平均年長為 365.2425 日。頁面中的 365.25 是計算器自身的換算係數，不應被理解為公曆標準對每一年長度的定義。

陽曆和農曆輸入最終比較的是公曆日期

兩個日期區都可以選擇陽曆或農曆。陽曆模式直接選擇 YYYY-MM-DD；農曆模式依次選擇年、月、日，遇到相應年份的閏月時會把普通月與閏月分開列出。農曆選擇會先對應成一個公曆日期，再進入完全相同的日期差公式，因此結果中的“月”不是農曆月數。

農曆年份可選 1900—2100。開啟頁面時，開始日期和結束日期預設相隔 30 天；兩個“設定為今天”按鈕可分別替換對應日期。輸入一變化，結果隨之重算，不需要另點提交按鈕。以上數值只由所選日期與固定換算係數產生，不讀取節假日、調休或地區工作日資料。

日期格式與曆法覈驗資料

設定日期後按用途選擇結果

1. 先確認原始日期採用哪種曆法

   合同、證件和常見日程通常直接寫公曆日期，可留在陽曆模式；只知道農曆生日或傳統日期時，再切到農曆並確認年份、是否閏月和具體日號。

2. 填寫開始與結束日期

   分別改動兩個日期欄位，或用“設定為今天”替換其中一項。頁面允許較晚日期放在開始欄，因為最終會取絕對值，但這樣不會保留先後方向。

3. 優先讀取相差天數

   需要覈對兩個日曆日隔了多久時，先看大號的天數。若只想做粗略週期彙報，再檢視整週、估算整月、估算整年或總小時。

4. 複製並保留口徑

   複製單個結果時，最好同時記錄兩個輸入日期以及“絕對間隔、向下取整”的口徑。只儲存一個“1個月”會丟失實際是 31 天還是其他跨度的資訊。

用 31 天跨度復算所有結果

把開始日期設為 2024-01-01，結束日期設為 2024-02-01。兩者相差 31 天，所以頁面應顯示：31 天、4 周、1 月、0 年、744 小時。

邊界對照：2024-02-28 到 2024-03-01 跨過閏日，結果是 2 天和 48 小時；把這兩個日期互換，結果仍是 2 天。該例同時驗證了閏日會進入總天數、日期順序不會生成負數。

首尾計數、整年顯示與功能邊界

相差天數包含開始日和結束日嗎？

它表示兩個日期之間跨過了多少個日曆日邊界。2024-01-01 到 2024-01-02 顯示 1 天，而不是把首尾都算入得到 2 天；若業務規則明確要求首尾兩天都計數，可在總天數上加 1，但其他結果需按新口徑另行換算。

開始日期晚於結束日期會出現負數嗎？

不會。頁面取絕對差，所以交換兩個輸入後，天、周、月、年、小時五項都不變。需要判斷“已過去”還是“還剩”時，必須自行根據兩個日期的先後關係解釋。

為什麼整整一個公曆年可能顯示 0 年或 11 月？

因為年和月卡片使用固定平均長度並向下取整。例如 2023-01-01 到 2024-01-01 相差 365 天，floor(365 ÷ 365.25) = 0，floor(365 ÷ 30.44) = 11。總天數仍是 365；判斷週年應比較公曆月日，而不是讀取這兩個估算卡片。

可以計算時分秒、工作日或節假日嗎？

當前輸入只到日期，輸出只含天、完整週、估算月、估算年和整小時，不顯示分鐘或秒，也不排除週末、法定節假日和調休日。需要精確時刻或工作日口徑時，應使用包含明確時區和地區日曆的專門計算方法。

正式期限前要複覈的邊界

總天數是這個頁面最直接的結果；月數和年數只是固定平均長度的向下取整估算。合同履行、年齡資格、保險期間、簽證停留、勞動考勤或申報截止等正式事項，必須以適用規則對起算日、屆滿日、節假日順延和所在地時區的規定爲準。

• 沒有自然月拆分：結果不會輸出“1年2個月3天”，也不會按月末逐月推算；不要用估算月數判斷賬期、生日或週年。
• 沒有方向：絕對值會隱藏先後順序。儲存結果時同時保留原始日期，避免把“已過去 30 天”誤讀成“還剩 30 天”。
• 只到日期：兩個輸入都沒有時分秒或時區欄位，小時數只是日期跨度的等價表達，不適合航班、班次、直播或跨時區會議。
• “今天”需覈對：頁面按協調世界時的日期生成“今天”。當所在地日曆日與協調世界時日期不一致時，按鈕可能與本地當天相差一天，應以輸入框顯示值爲準並手動修正。
• 農曆範圍有限：農曆下拉年份為 1900—2100；香港天文臺公開對照覆蓋 1901—2100，不能用該資料替頁面的 1900 年邊界背書。遠期農曆日期用於重要事項時還應與屆時官方曆書交叉覈對。
• 不計算工作日：結果不讀取任何地區的節假日或調休安排。專案工期、請假、營業日和辦事期限應另按實際日曆逐日覈算。