このツールでできること
「期間内の曜日数計算ツール」は、指定した2つの日付の間に、月曜・火曜・水曜・木曜・金曜・土曜・日曜がそれぞれ何回含まれるかを、両端の日付を含めて(両端含む)算出します。あわせて期間の総日数も表示します。シフト表の作成、給与計算、稼働日数の集計はもちろん、「今年は金曜日が何回ある?」といった素朴な疑問にもすぐ答えられます。
使い方
年・月・日の入力欄で開始日と終了日を指定します。通常の日付であれば、暦の設定は「西暦(グレゴリオ暦)」のままにしておいてください。便利機能として、和暦(明治・大正・昭和・平成・令和)での入力にも対応しています。和暦を選んだ場合、入力した年は元号の年として扱われ、計算前に西暦へ変換されます。日数の計算ロジック自体は世界共通であり、特定の国に依存するものではありません。
計算式
各日付を通し番号(シリアル値)に変換します。両端を含む総日数は 総日数 = 終了シリアル値 − 開始シリアル値 + 1 で求めます。1週間は7日なので、どの曜日も少なくとも 基本回数 = 総日数 ÷ 7(整数商) 回は出現します。余りである 剰余 = 総日数 mod 7 日分が追加の出現分となり、開始日の曜日から順番に1回ずつ割り当てられます。グレゴリオ暦における任意の日付の曜日は、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年1月1日(月曜)から2024年12月31日(火曜)までの場合:2024年はうるう年なので総日数 = 366。基本回数 = \(366 \div 7 = 52\)、剰余 = \(366 \bmod 7 = 2\) となります。月曜から数え始めるため、最初の2曜日(月曜と火曜)にそれぞれ +1 されます。結果は、月曜が53回、火曜が53回、その他の曜日はすべて52回ずつで、合計すると366日になります。
一般的な日付範囲の曜日カウント
カウントは開始日と終了日の両方を含みます。N日間の範囲には、どの曜日も\(\lfloor N/7 \rfloor\)回ずつ含まれ、さらに開始日の曜日から数えて最初の\(N \bmod 7\)個の曜日にはもう1回ずつ追加されます。
| 範囲 | 合計日数 | 月 | 火 | 水 | 木 | 金 | 土 | 日 |
|---|---|---|---|---|---|---|---|---|
| 任意の1週間(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日の2月、例:2023年2月 | 28 | 4 | 4 | 4 | 4 | 4 | 4 | 4 |
どの曜日が追加で1回多く出現するのか?
- 余りが0(7日、14日、28日など):追加はなく、すべての曜日が同じ回数ずつ出現します。
- 余りが1(例:365日):開始日の曜日だけが1回多く出現します。2023年は日曜日に始まったため、日曜日が53回あります。
- 余りが2(例:366日):開始日の曜日とその次の曜日です。2024年は月曜日に始まったため、月曜日と火曜日が53回になります。
- 余りが3(例:31日の月):開始日の曜日とその次の2つの曜日です。月曜日に始まる月には、月曜日、火曜日、水曜日が5回ずつあります。
- 一般に余りが1から6の場合:開始日の曜日から数えて、その個数分の最初の曜日が基準より1回多く出現します。
30日の月は余りが2なので、開始日の曜日とその次の曜日が5回ずつ出現します。
主な用語
- 包括的カウント
- 開始日と終了日の両方が数えられます。月の1日から7日までは6日ではなく7日間です。したがって\(N = \text{通し番号}_{\text{終了}} - \text{通し番号}_{\text{開始}} + 1\)となります。
- 日の通し番号
- 固定の基準日からの日数を連続して数えたものです。2つの通し番号を引くと、月や閏年の計算をせずに2つの日付の間の日数が得られます。
- 基準値(totalDays を7で割った商)
- 整数の商\(\lfloor N/7 \rfloor\)です。範囲内でどの曜日も出現する回数を表します。
- 余り(totalDays を7で割った余り)
- 残りの\(N \bmod 7\)で、0から6の値をとります。1回多く出現する曜日の数を表します。
- 開始曜日からの位置
- 開始日の曜日\(w_0\)を基準とした曜日\(w\)の位置、\((w - w_0) \bmod 7\)です。この位置が余りより小さい曜日は、1回多く出現します。
- 直前投影グレゴリオ暦
- グレゴリオ暦の規則(4年ごとに閏年、ただし400で割り切れない世紀年は除く)を、実際に採用された1582年より前の日付にまで遡って適用したものです。この方式で求めた日付は、ユリウス暦で記録された歴史的な記録と一致しない場合があります。
- 坂本のアルゴリズム
- グレゴリオ暦の日付の曜日を求める簡潔な方法です。月ごとの小さなオフセット表を使い、1月と2月は年から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\)回出現します。1回多く出現するのは、開始日の曜日から数えて最初の\(r\)個の曜日です。
例:水曜日から始まる15日間の場合、\(15 = 2 \times 7 + 1\)です。どの曜日も2回ずつ出現し、水曜日はさらに3回目が加わります。
制限事項:これらのカウントは純粋に暦に基づくものです。国や地域によって異なる祝日や、月曜日から金曜日以外の勤務体系(一部の国では日曜日から木曜日など)は考慮されていません。交代制勤務のパターンや会社の休業日も含まれていません。正確な営業日数が必要な場合は、これらの日を自分で差し引いてください。
よくある質問
両端の日付は含まれますか? はい、開始日・終了日のどちらも含みます。開始日と終了日が同じ場合(開始日=終了日)、総日数は1日です。
開始日が終了日より後になっている場合は? 自動的に2つの日付を入れ替えるため、総日数は常に正の値になります。
どの暦を使用していますか? 全期間を通じて先発グレゴリオ暦(プロレプティック・グレゴリオ暦)を用います。現代の日付であれば日常で使う暦と完全に一致しますが、1582年以前の非常に古い日付では、歴史上のユリウス暦の記録とずれる場合があります。