這個計算器的功能
「日期區間星期幾天數計算器」可以告訴你在兩個日期之間,星期一、星期二、星期三、星期四、星期五、星期六與星期日各出現幾次,並且把起訖兩天都計入(含頭尾)。它也會列出整段期間的總天數。無論是排班、計算薪資、統計工作日,或只是想知道「今年總共有幾個星期五?」,都能派上用場。
使用方式
透過年、月、日欄位選擇起始日期與結束日期。一般日期請將曆制維持在「西曆(公元/格里曆)」即可。本工具另外提供日本年號模式(明治、大正、昭和、平成、令和)作為輔助選項,這是日本特有的紀年方式:選用後,你輸入的年份會被視為該年號的年數,並先換算成對應的西曆年份再進行計算。底層的日期運算是通用的,不受任何國家規則影響;台灣讀者若慣用民國紀年,可自行將民國年加 1911 換算成西曆後輸入。
計算公式
每個日期都會先轉換成一個天數序號。含頭尾的總天數為 $$\text{totalDays} = \text{endSerial} - \text{startSerial} + 1$$ 由於一週有七天,每個星期幾至少會出現 \(\text{baseline} = \text{totalDays div } 7\) 次。剩下的 \(\text{remainder} = \text{totalDays mod } 7\) 天則是額外出現的次數,會從起始日期的星期幾開始,依序往後分配。任何格里曆日期是星期幾,則以 Sakamoto 演算法求得。
$$\text{Count}(w) = \left\lfloor \frac{N}{7} \right\rfloor + \bigl[\,(w - w_0) \bmod 7 < (N \bmod 7)\,\bigr]$$$$\text{where}\quad \left\{ \begin{aligned} N &= (\text{Serial}_{\text{end}} - \text{Serial}_{\text{start}}) + 1 \\ \text{start} &= \text{Start Yr}/\text{Mo}/\text{Day} \\ \text{end} &= \text{End Yr}/\text{Mo}/\text{Day} \\ w_0 &= \text{weekday of start date} \end{aligned} \right.$$
實例演算
以 2024-01-01(星期一)到 2024-12-31(星期二)為例:2024 年是閏年,因此 \(\text{totalDays} = 366\)。\(\text{baseline} = 366 \div 7 = 52\),\(\text{remainder} = 366 \bmod 7 = 2\)。從星期一開始,前兩個星期幾(星期一與星期二)各 +1。結果為:星期一 53 次、星期二 53 次,其餘每個星期幾各 52 次——加總剛好是 366 天。
常見日期範圍的星期計數
計數同時包含開始日期與結束日期。任何 N 天的範圍,每個星期幾都會出現 \(\lfloor N/7 \rfloor\) 次,另外前 \(N \bmod 7\) 個星期幾(從開始日期的星期開始計算)各多出一次。
| 範圍 | 總天數 | 週一 | 週二 | 週三 | 週四 | 週五 | 週六 | 週日 |
|---|---|---|---|---|---|---|---|---|
| 任何一個完整星期(7 天) | 7 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
| 平年,2023年1月1日至2023年12月31日(從星期日開始) | 365 | 52 | 52 | 52 | 52 | 52 | 52 | 53 |
| 閏年,2024年1月1日至2024年12月31日(從星期一開始) | 366 | 53 | 53 | 52 | 52 | 52 | 52 | 52 |
| 31 天的月份,例如 2024 年 1 月(從星期一開始) | 31 | 5 | 5 | 5 | 4 | 4 | 4 | 4 |
| 28 天的二月,例如 2023 年 2 月 | 28 | 4 | 4 | 4 | 4 | 4 | 4 | 4 |
哪些星期幾會多出一次?
- 餘數為 0(7、14、28 天等):沒有額外次數,每個星期幾出現的次數相同。
- 餘數為 1(例如 365 天):只有開始日期的星期幾多出一次。2023 年從星期日開始,因此有 53 個星期日。
- 餘數為 2(例如 366 天):開始日期的星期幾及其後一天。2024 年從星期一開始,因此星期一和星期二各有 53 次。
- 餘數為 3(例如 31 天的月份):開始日期的星期幾及其後兩天。以星期一開始的月份會有五個星期一、星期二和星期三。
- 一般而言,餘數為 1 至 6:從開始日期的星期幾起算,前幾個星期幾會比基準次數多出一次。
30 天的月份餘數為 2,因此開始日期的星期幾及其後一天各出現五次。
關鍵術語
- 包含式計數
- 開始日期與結束日期都會被計算。從某月 1 日到 7 日是 7 天,而不是 6 天,因此 \(N = \text{序號}_{\text{結束}} - \text{序號}_{\text{開始}} + 1\)。
- 日序號
- 從固定參考日期開始的連續天數計數。兩個序號相減,即可得出兩日期之間的天數,無需處理月份或閏年。
- 基準值(totalDays div 7)
- 整數商 \(\lfloor N/7 \rfloor\)。這是範圍內每個星期幾出現的次數。
- 餘數(totalDays mod 7)
- 剩餘的 \(N \bmod 7\),數值介於 0 至 6。它是會多出一次的星期幾數量。
- 開始星期偏移量
- 星期 \(w\) 相對於開始日期星期 \(w_0\) 的位置,即 \((w - w_0) \bmod 7\)。當此偏移量小於餘數時,該星期幾會多出一次。
- 推算格里曆
- 將格里曆規則(每 4 年一個閏年,但不能被 400 整除的世紀年除外)向前延伸到 1582 年正式採用該曆法之前的日期。這些日期可能與依照儒略曆所作的歷史紀錄不同。
- 坂本演算法
- 一種求出格里曆日期星期幾的簡便方法。它使用一張小型的月份偏移表,若為一月或二月則將年份減 1,並計算 \((y + \lfloor y/4 \rfloor - \lfloor y/100 \rfloor + \lfloor y/400 \rfloor + t_m + d) \bmod 7\)。結果為 0 代表星期日。
解讀你的星期計數
- 工作日:將週一至週五的次數相加,即可得出範圍內的曆法工作日數,假設採用週一至週五的工作週,且尚未扣除任何國定假日。
- 週末日:將週六和週日的次數相加,即可得出週末日數。工作日加上週末日,必定等於總天數。
- 完整星期:範圍恰好為 \(7k\) 天時,包含每個星期幾各恰好 \(k\) 次,因此各星期幾的次數全部相同。
- 餘數:若總天數為 \(7k + r\),其中 \(0 \le r \le 6\),則有 \(r\) 個星期幾出現 \(k+1\) 次,其餘出現 \(k\) 次。多出的那些星期幾,是從開始日期的星期幾起算的前 \(r\) 個星期幾。
範例:若從星期三開始計算 15 天,則 \(15 = 2 \times 7 + 1\)。每個星期幾各出現兩次,而星期三再多出一次。
限制:這些次數純粹以曆法為依據。它們不考慮因國家和地區而異的國定假日,也不考慮不是週一至週五的工作週(例如部分國家採用的週日至週四)。輪班制度和公司休假也未納入。若需要精確的工作日數,請自行扣除這些日子。
常見問題
計算結果有含頭尾嗎?有的——起始日與結束日都會算進去。若只有一天(起始日=結束日),總天數即為 1。
如果起始日期比結束日期晚怎麼辦?系統會自動交換兩個日期,因此總天數永遠為正數。
使用哪一種曆法?全程採用外推格里曆(proleptic Gregorian)。對於現代日期,這與日常使用的民用曆完全一致;但 1582 年以前的非常古老日期,可能會與歷史上的儒略曆記載有所出入。