ライブラリなしで解く終末日の日付計算
1960年の終末予言の見出しを題材に、ライブラリなしで曜日を計算する難しさと、日付演算に潜む落とし穴を解説します。

1960年の『Science』誌の記事が「2026年11月13日の金曜日が終末日だ」と指摘した、古い見出しが再び出回っています。この予言自体は、プログラマーにとってそれほど面白くありません。面白いのは、その日付が本当に金曜日であり、答えを出すには日付演算が必要になる点です。うるう年のルール、月の日数、世紀の例外、負の年、そして人を感心させる数式と本番環境で生き残るコードとの静かな違い。
その見出しの元になった論文は、ハインツ・フォン・フェルスターらによるもので、挑発的な雰囲気があります。彼らは人口増加を調べ、指数関数より速いと論じ、双曲線を当てはめて分母がゼロに近づくに任せました。その結果、タブロイド紙向けにぴったりな日付を持つ特異点が現れました。歴史家や人口学者はその深刻さをめぐって議論していますが、警告と冗談が半々に読めます。金曜日の13日がどれほど劇的に響くかを、書き手が正確にわかっていたかのように。
私がいつも立ち返るのは、その下に隠れた職人技です。予測をからかう前に曜日を検証し、曜日を検証する前にどのカレンダーを指すのかを決める必要があります。グレゴリオ暦の延長(proleptic)でしょうか。ある国の実際の市民暦でしょうか。天文学的な年番号か、歴史家が使うゼロ年なしの慣習か。多くの人はdatetime、java.time、chronoに手を伸ばして次に進みます。それは通常正しい判断です。ただ、ライブラリを使わずにやってみる演習は、ルールが有限で、古く、罠だらけであるがゆえに、プログラミングで最良の正しさの訓練の一つであり続けます。
終末日の見出しはカレンダーの問題である
まず主張そのものから。2026年11月13日は金曜日です。REPLで数秒で確認できます。手計算でやる意味は速さではありません。モデルを露わにすることです。カレンダーは不規則な遷移をもつステートマシンです。ほとんどの月は30日か31日で進み、2月はうるう年で形が変わり、世紀の年は400で割り切れない限りうるう年になりません。グレゴリオ暦ではそのパターン全体が400年周期で繰り返されます。この周期が見えると、曜日計算は数秘術ではなく、慎重に設計された周期上の剰余演算になります。
コンウェイの終末日アルゴリズムは、覚えやすい人間向けの手法です。各世紀には基準となる曜日があり、2000年代は火曜日です。2026年のような年なら、下2桁の26を取ります。12で割ると商は2、余りは2。余りの中のうるう年の数(ゼロ)を加えます。2+2+0は4で、火曜日に4を足すと土曜日。これがその年の「終末日」、つまり4/4、6/6、8/8、10/10、12/12、2月の最終日、11月7日など、覚えやすい目印の日に共通する曜日です。2026年11月7日が土曜日なら、11月13日は6日後で金曜日。見出し向けには劇的で、紙ナプキンで計算できるほど機械的です。
この心理的な手法が優れているのは、カレンダーを少数の目印へ圧縮しているからです。しかし圧縮はバグの温床にもなります。終末日アルゴリズムはグレゴリオ暦のうるう年ルールを前提とし、一般的な世紀の基準日を前提とし、暦の改革をまたがないことを前提とし、1月と2月を普通の月として扱わないことを前提としています。それは見事なローカルツールですが、日付ライブラリではありません。
実際のコードで曜日計算が壊れる理由
カレンダーのバグは、派手な形で知らせてくることはほとんどありません。うるう日の後に更新メールが1日早く送られる、2月のたびに請求期間の終端が抜ける、誰も想定しない世紀の境界をまたいで週次ジョブがずれる、あるいは歴史学者のデータセットで、年ゼロがISO 8601と博物館の目録で違う意味を持つ、といった形で現れます。仕様と実装のギャップこそ、まさにこうした欠陥が潜む場所です。誰もがそのルールは自明だと思っていて、二つの自明なルールがぶつかるまで気づかないのです。
典型的な境界ケースは2000年です。100で割り切れますが、400で割り切れるのでうるう年です。1900年はうるう年ではありませんでした。2100年もそうなりません。手書きのうるう年判定の多くはyear % 4 == 0だけを覚えて、そこで止まります。これはスタートアップが気にするほとんどの年では正しいものの、十分に長い期間で見ると間違います。金融システム、アーカイブ、インフラは今やそれほど長く生き延びるので、長期的な視野はもはや理論上の話ではありません。
- うるう年ルールの簡略化: 完全なグレゴリオ暦ルールではなく
y % 4を使う。 - 月番号の罠: 人間は1月を1と数えるが、多くのAPIは0を使い、ツェラーの公式は3月から始める。
- 負の年の意味: 天文学的なゼロ年と、紀元前1年の後に紀元1年が続く歴史的な扱い。
- 週の起点: 日曜始まり、月曜始まり、土曜始まりが式ごとに異なる。
- 暦の改革: ある地域が歴史的にグレゴリオ暦を採用する前に、そのルールを適用してしまう。
- 整数除算: C言語は0方向へ切り捨てるが、カレンダー計算では床除算(フロア除算)が欲しいことが多い。
これらの多くが算術の誤りではなく、表現の誤りであることに注目してください。ここに言語設計とライブラリ設計の深い教訓があります。日付は見栄えのよい整数ではありません。有効性のルール、エポック、エポック以前の年の慣習、そして上記すべてに依存する曜日への対応づけを持つ、暦体系の中の値です。良いAPIは無効な状態を扱いにくくします。悪いAPIは整数を三つ渡して、幸運を祈れと言います。
ツェラー、終末日、そして公式の形
ツェラーの合同式は、コンウェイの手法より古く、気難しい親戚です。グレゴリオ暦では、3月を月14、4月を月15とし、1月と2月は前年の13月と14月として扱う形でよく書かれます。日をq、月をm、世紀内の年をK、0始まりの世紀をJとすると、一般的な形の一つはh = (q + floor(13(m+1)/5) + K + floor(K/4) + floor(J/4) + 5J) mod 7で、h = 0は土曜日を意味します。動きはします。しかし慣習の地雷原でもあります。
公表されているバリエーションは複数あり、曜日の起点が異なるもの、ユリウス暦用のもの、減算ではなく加算を用いるものなどがあります。フォーラムからコピーすると、1901年から2099年までは正しいのに端で間違う式や、著者が想定した床除算の挙動を言語が取っている場合にだけ正しい式になることがあります。だから私はツェラーを本番コードとして提示するのが好きではありません。構造を理解するには素晴らしいものです。線形の日の項、不規則な月の長さを近似する月の補正、年の項、うるう年の補正、世紀の補正という構造が見えます。しかし保守担当者があなたがどの慣習を使ったのかを逆算しなければならないとき、あまり素晴らしくありません。
コンウェイの手法は人間の記憶に最適化され、ツェラーは代数的な簡潔さに最適化されています。本番コードは監査しやすさに最適化されるべきです。これらは異なる目標です。言語設計の観点では、賢いマクロと、名前に不変条件が込められた退屈な関数との違いのようなものです。名前に不変条件を持つ、退屈な関数がもっと必要です。

監査できる小さなグレゴリオ暦のコア
制約のあるコードで曜日ロジックが必要なら、私の好みの基準はHoward Hinnantのdays-from-civilの構成です。グレゴリオ暦の日付を、1970年1月1日を基準とした通算日数に変換し、既知の木曜日からの剰余演算で曜日を求めます。実装は短いですが、どの定数にも理由があります。年をずらして3月を年の最初の月にすることで、分岐の多い月テーブルを避けています。うるう日はずらした年の末尾に来るので、それより前の計算を乱しません。
typedef long long i64;
/* Gregorian proleptic calendar; March is treated as the first month. */
static i64 days_from_civil(i64 y, int m, int d) {
y -= m <= 2;
i64 era = (y >= 0 ? y : y - 399) / 400; /* floor-ish 400-year era */
int yoe = (int)(y - era * 400); /* year of era, 0..399 */
int mp = m + (m > 2 ? -3 : 9); /* Mar=0 ... Feb=11 */
int doy = (153 * mp + 2) / 5 + d - 1; /* day of shifted year */
int doe = yoe * 365 + yoe / 4 - yoe / 100 + doy;
return era * 146097 + doe - 719468; /* 1970-01-01 == 0 */
}
/* Returns 0=Sunday, 1=Monday, ... 6=Saturday. */
static int weekday_gregorian(i64 y, int m, int d) {
i64 z = days_from_civil(y, m, d);
int r = (int)((z + 4) % 7); /* 1970-01-01 was Thursday */
if (r < 0) r += 7;
return r;
}
マジックナンバー153は敬意を払うに値します。ずらした3月から2月までの月の長さは、30日と31日に近いパターンで交互になりますが、(153 * mp + 2) / 5によって、ルックアップテーブルなしで各月の前までの累積日数を表しています。146097は400年のグレゴリオ周期の日数です。4世紀分の146,000日に、97回のうるう日を足したものです。719468を引くと、カウントをUnixエポックに合わせ直します。どれも神秘的ではありません。カレンダーの仕様を算術に蒸留したものです。
ここで型の選択が重要になります。通算日数には符号付きの広い整数を使いましょう。実装しているのが厳密にはproleptic Gregorianである場合は、それを明示してください。4月31日のような範囲外の日を拒否するか正規化するかを決めてください。私は市民の日付では拒否する方が好きです。黙って繰り上がると上流のバグが隠れるからです。紀元前の入力を受け付けるなら、最初の減算が行われる前に、どの番号体系を使うのかを明記してください。これらは一見ライブラリの関心事に思えますが、日付が複雑だと認めたくない、ファームウェアのblobやストアドプロシージャの中でも同じ規律が必要です。
タイムゾーンはカレンダー計算ではない
曜日は、時間のスケールと場所を確定させて初めて安定します。東京の00:30の会議は、サンフランシスコではまだ前の市民日付です。システムがインスタントを保存しているなら、曜日を問う前にタイムゾーンデータベースを通して変換してください。システムが市民日付を保存しているなら、ゾーンを付けずに気軽にインスタントへ変換しないでください。失敗のモードは微妙です。二つのサービスがタイムスタンプには同意しながら、日付では意見が割れることがあるのです。
だから私はコードレビューで三つの概念を分けて考えます。インスタントは物理的なタイムライン上の一点です。市民日付は2026-11-13のような法律上または社会的なラベルです。ローカル時刻は、市民ラベルとゾーン、そのオフセットの履歴の組み合わせです。曜日の問いは主に市民日付に属します。スケジュールの問いは、インスタントとゾーンに属します。コードがこれらを混ぜると、どんなに綺麗な数式も取り憑かれたようになります。ここでの防御的エンジニアリングとは、タイムスタンプにユーザーのカレンダーを知っているふりをさせないことです。
うるう秒も、曜日の議論に持ち込まれがちな要素です。市民の曜日計算では無視してください。曜日は、平滑化された原子時計の時間ではなく、カレンダーの日に従います。うるう秒を平滑化したり、期間の計測に単調時計を使ったりするのは構いません。ただ、それが「これは金曜日か?」という問いに漏れ出ないようにしてください。金曜日は社会的な事実です。
CIに置く価値のあるテスト
日付のコードが信頼を得るのは、雰囲気ではなく敵対的なフィクスチャによってです。厄介なケースを関数の隣に置きましょう。1900-02-28と1900-03-01が、間にうるう日がない隣接日であることをテストします。2000-02-29が存在することをテストします。2099-12-31から2100年へ繰り上がるところをテストします。4年ごとだけのルールが誤るところです。エポックとして1970-01-01が木曜日であることをテストします。負の年をサポートすると主張するなら、そのテストも行い、演算の前に不正な入力を拒否することもテストしてください。
プロパティテストは、そのプロパティが正直であれば役立ちます。有効な任意の日付について、1日足すと曜日が7を法として1つ進むこと。グレゴリオ暦の400年には146,097日があり、同じ曜日に戻ること。非うるう世紀の内部では、終末日型の目印は、実装が一貫している場合にのみ同じ曜日を共有すること。避けたい誤解と同じ誤解で生成されたライブラリに対してテストしてはいけません。期待値は標準から、または独立して導いた表から固定してください。
日付のルーチンは、その慣習が退屈で、明示的で、暦が気を変える境界で検証されているとき、正しいと言えます。
終末日そのものについては、期待値はコメントにハードコードできるほど単純です。プロレプティック・グレゴリオ暦のルールでは、2026-11-13は金曜日です。その周辺の経路も加えましょう。2026-11-07は終末日の目印となる土曜日、2026-02-28は土曜日、2027-02-28は平年の後の日曜日、2028-02-29は2028年が4で割り切れ100では割り切れないので存在します。こうした小さな組み合わせは、ランダムな100万件のケースより、1日ずれのバグをよく捕まえます。

新しいモデルへの古い教訓
1960年の終末曲線が人口統計として失敗したのは、人間のシステムが当てはめた直線上の受動的な点ではないからです。出生率は変わり、政策は変わり、農業も都市化も変わり、特異点は見出しが語り続ける未来に留まりました。この失敗は、プログラマーにとっても有用です。モデルは内部的に一貫し、歴史的な根拠があっても、研究対象のシステムが測定しているあいだにルールを書き換えていれば、間違うことがあるのです。
カレンダーの計算はその反対の贅沢があります。ルールは遅く、公開されていて、ほぼ安定しています。つまり仕様を尊重すれば、正しさは達成可能です。だから日付は、より広い習慣の格好の訓練場になります。モデルに名前を付け、コアをタイムゾーンや入出力から切り離し、慣習を明示し、連続性が途切れる場所をテストすること。組込み機器のRTC向けにCを書くにせよ、クエリプランナーにせよ、言語ランタイムの検証層にせよ、得られるものは同じです。退屈な明快さは、賢い確信に勝ります。
そう、金曜日の13日は予定通りやって来ます。黙示録は必要ありません。本当に怖いのは、チームが半分しか覚えていない合同式と、誰も書き留めなかった前提から、ほぼ動くだけの曜日ロジックを出荷できてしまうことです。単純なことを厳密にやりましょう。400年周期を実装し、不正な日付を拒否し、インスタントと市民ラベルを分けておき、将来の保守担当者が検証できる定数の跡を残してください。終末日は、予報よりも良い単体テストになります。


