日付の計算:月末・うるう年・夏時間の1日をまたぐ

日付講座4。1月31日+1か月が7つのツールで2月28日と3月3日に割れる表、2月29日+1年、海外の夏時間で23時間になる1日と壁時計で足すPythonやPHPの「24時間」、年度・学年の区切り、満年齢、営業日の計算と速度を実行結果で確認。

シリーズ:日付・時刻・タイムゾーン講座 4/6(中級)。 日付を読んで表示できる(第3回)ようになり、次に更新日・試用期間・「明日の同じ時刻」のリマインダー・年齢・納期の営業日を計算する段階の人向けです。読み終えると、典型的な境界ケースで7つのツールが何を返すかを1枚の表で把握し、意見が割れる規則についてはそのまま貼れる短い関数を手に入れています。

日付の計算は、29日を過ぎるまでは整数の計算に見えます。1月31日に始めたサブスクの更新日がある言語では2月28日、別の言語では3月3日になる。2月29日生まれの人の誕生日処理が4年に1度だけ例外を出す。日本国内だけなら気づかない夏時間で、海外向けの「毎日正午」の通知が1時間ずれる。どれも Apple Silicon Mac(M1 Pro)で Python 3.9.6、PHP 8.5.6、Java 26、.NET 10.0.14、Swift 6.4.2、Dart 3.11.5、SQLite 3.51.0、macOS の jsc を TZ=… 指定付きで実行した結果です。

暦の単位と固定の長さ

「時間の量」には2種類あり、バグの多くはこれを混ぜることから生まれます。

  • 固定の長さ(duration) は秒数です。24時間は常に 86,400 秒。Java の Duration(PT24H)、Python の timedelta、Dart の Duration。
  • 暦の期間(period) は暦で数えます。「1か月」「1年」「1日」。秒数は起点によって変わります。Java の Period(P1M、P1D)、PHP の DateInterval。

Java では Duration.ofDays(1) が PT24H、Period.ofDays(1) が P1D と表示され、違いが目に見えます。1か月は決して固定の長さではなく、夏時間のあるゾーンでは1日も同じです。

1月31日+1か月:7つのツールを1枚の表で

2026年2月は28日までなので、「1月31日の1か月後」には正確な答えがありません。全ツールに聞きました。

ツール(呼んだもの) 2026-01-31 +1か月 2026-03-31 −1か月 2028-02-29 +1年
Python の関数(後述) 2026-02-28 2026-02-28 2029-02-28
Python date.replace(month=2) ValueError: day is out of range for month — ValueError(同じ文)
Java plusMonths / plusYears 2026-02-28 2026-02-28 2029-02-28
.NET AddMonths / AddYears 2026-02-28 2026-02-28 2029-02-28
Swift Calendar.date(byAdding:) 2026-02-28 2026-02-28 2029-02-28
PHP modify('+1 month')、add(P1M) 2026-03-03 2026-03-03 2029-03-01
JavaScript setUTCMonth / setUTCFullYear 2026-03-03 2026-03-03 2029-03-01
Dart DateTime.utc(2026, 2, 31) 2026-03-03 2026-03-03 (2027-02-29 → 2027-03-01)
SQLite date(d, '+1 month') 2026-03-03 2026-03-03 2029-03-01
SQLite 'floor' 付き 2026-02-28 — 2029-02-28
図。起点は 2026-01-31 に1か月。2026年2月は28日しかないのでツールが分かれる。2026-02-28 に丸める:calendar.monthrange を使った Python 標準ライブラリの関数、Java plusMonths、.NET AddMonths、Swift Calendar、floor 修飾子付きの SQLite。2026-03-03 に繰り越す:PHP modify('+1 month') と add(P1M)、JavaScript setMonth、Dart DateTime(2026, 2, 31)、floor なしの SQLite date()。
2026年1月31日に1か月を足した結果(本文で各ツールを実行)。月末に丸める派と、あふれた日数を翌月に繰り越す派の2つに分かれた。

2列目をよく見てください。PHP・JavaScript・Dart・SQLite では 3月31日の1か月前が3月3日 です。月を2月にし、日の31をそのまま残し、存在しない「2月31日」を3日分繰り越して正規化するからです。どちらの流派も間違いではなく、答えている質問が違います。経理が「毎月」と言うときは月末に丸める方であることが多いでしょう。

Python の標準ライブラリには月の加算がありません(よく使われる relativedelta はサードパーティのパッケージで、ここでは使っていません)。Java と同じく丸める関数です。

import calendar
from datetime import date

def add_months(d: date, n: int) -> date:
    y, m = divmod(d.month - 1 + n, 12)
    y += d.year; m += 1
    return d.replace(year=y, month=m, day=min(d.day, calendar.monthrange(y, m)[1]))

PHP では last day of next month と書くと丸めた 2026-02-28 が返りました。JavaScript では new Date(Date.UTC(2026, 2, 0))(3月の0日目)が 2026-02-28 になり、月の日数を求めるのに使えます。

月の加算は結合法則が成り立たない

丸めると情報が消えます。Java は chained -> 2026-03-28 vs plusMonths(2) -> 2026-03-31 と表示し、.NET と Python の関数も同じでした。毎月の更新日は最初の基準日から start.plusMonths(n) で求め、前回の更新日から足してはいけません。さもないと1月31日契約の顧客は2月以降ずっと28日になります。PHP の modify('+1 month') を重ねると逆方向にずれ、01-31 → 03-03 → 04-03 でした。

差の計算も一致しません。2026-01-31 から 2026-03-01 まで、Java の Period.between は P1M1D、PHP の diff() は 0 months 29 days で、合計29日だけは一致しました。

年度と学年:日本特有の区切り

日本の業務システムでは、暦年より 年度(4月1日〜翌年3月31日)で集計することが多く、学校関係では 学年 の区切りが4月2日です(4月1日生まれは早生まれ側)。どちらも1行で書けますが、混同すると1年ずれます。

from datetime import date
def fiscal_year(d: date) -> int:          # 年度
    return d.year if d.month >= 4 else d.year - 1
def school_cohort(birth: date) -> int:    # 同じ学年: 4月2日〜翌年4月1日生まれ
    return birth.year if (birth.month, birth.day) >= (4, 2) else birth.year - 1
2026-03-31 -> 年度 2025
2026-04-01 -> 年度 2026
2027-01-15 -> 年度 2026
2019-04-01 -> cohort 2018 (fiscal_year would say 2019 )
2019-04-02 -> cohort 2019 (fiscal_year would say 2019 )
2020-04-01 -> cohort 2019 (fiscal_year would say 2020 )
2020-04-02 -> cohort 2020 (fiscal_year would say 2020 )

4月1日生まれを年度の式で計算すると、1学年ずれました。区切りの境界日(3月31日・4月1日・4月2日)は必ずテストに入れます。

うるう年:1900年・2000年と2月29日

グレゴリオ暦の規則は「4で割り切れる年はうるう年、ただし100で割り切れる年は平年、ただし400で割り切れる年はうるう年」。Python の calendar.isleap、Java の Year.isLeap、.NET の DateTime.IsLeapYear、PHP の format('L') は全員一致で 1900 が平年、2000 がうるう年でした。簡略版の y % 4 == 0 は1601〜2400年のうち [1700, 1800, 1900, 2100, 2200, 2300] の6年だけ calendar.isleap と食い違いました。

壊れるのはうるう日そのものです。

Java   LocalDate.of(2026, 2, 29)  -> Invalid date 'February 29' as '2026' is not a leap year
.NET   new DateTime(2026, 2, 29)  -> Year, Month, and Day parameters describe an un-representable DateTime.
Python date(2028,2,29).replace(year=2029) -> ValueError: day is out of range for month

replace(year=...) は「3年は動いて4年目に落ちる」記念日・更新処理の定番バグです。「2月29日+1年」は Python の関数と Java が 2029-02-28、PHP・JavaScript・SQLite が 2029-03-01 でした。

1日と24時間:夏時間をまたぐと別物

Asia/Tokyo では Java の plusDays(1) はちょうど24時間でした。夏時間がないからです。しかし海外ユーザー向けの通知や海外リージョンのサーバーでは話が変わります。America/New_York は2026年3月8日(日)に 01:59:59 から 03:00:00 へ、Europe/Madrid は3月29日に同じく 01:59:59 から 03:00:00 へ時計が進みました(インストール済み tzdata を zdump -v で確認)。土曜の正午から計算すると次の通りです。

ツール +1日 +24時間
Java ZonedDateTime plusDays(1) → 12:00−04:00 plusHours(24) → 13:00−04:00
Python aware datetime + timedelta(days=1) → 12:00−04:00 + timedelta(hours=24) → 12:00−04:00
PHP modify() '+1 day' → 12:00−04:00 '+24 hours' → 12:00−04:00
PHP add(DateInterval) P1D → 12:00−04:00 PT24H → 13:00−04:00
Swift Calendar .day, 1 → 12:00−04:00 addingTimeInterval(86400) → 13:00−04:00
Dart ローカル(TZ=America/New_York) — add(Duration(days: 1)) → 13:00

「明日の同じ時刻」はどれも正しく、実際には23時間後でした(Java の Duration.between は 23、PHP のタイムスタンプ差は 82,800 秒)。驚きは「+24時間」の列です。Python の aware datetime は、同じ tzinfo 同士だと壁時計の計算をするので timedelta(hours=24) が正午に着地し、2つの差も 1 day, 0:00:00 と表示されました。UTC に変換してから引くと 23:00:00 です。PHP の modify('+24 hours') も同様で、add(new DateInterval('PT24H')) だけが本当の24時間を足しました。.NET の DateTimeOffset はゾーンではなく固定オフセットなので、AddDays(1) は 2026-03-08T12:00:00-05:00 というニューヨークがその日使っていないオフセットの値を返しました。

人の予定は「ユーザーのゾーンで暦の単位」、タイムアウトやトークンの有効期限など正確な長さは「UTC で固定の長さ」が原則です。

年齢と営業日

年齢は割り算ではなく暦の問題です。満年齢は1行で書けます。

def age(birth, today):
    return today.year - birth.year - ((today.month, today.day) < (birth.month, birth.day))

2000-05-20 生まれなら 2026-05-19 に 25、2026-05-20 に 26 を返しました。ありがちな (today - birth).days // 365 は 2026-05-14 からもう 26 で、うるう日の蓄積のせいで6日早く歳を取りました。誕生日 1950〜2010年、「今日」が2026年のランダムな組 10 万件(シード 42)で、days // 365 は 3,037件(3.04%)、int(days / 365.25) でも 104件(0.10%) 間違えました。なお日本の法律上の年齢の数え方(誕生日の前日に1つ加わるとされる扱い)や2月29日生まれの扱いは用途ごとに確認が必要で、ここではコードで決め打ちしないことだけを勧めます。

営業日(月〜金から祝日を除く)も日常的な計算です。1日ずつ回すループは読みやすく、計算版は丸ごとの週を5日と数えて余りだけ回します。

from datetime import date, timedelta
HOLIDAYS = {date(2026, 1, 1), date(2026, 5, 1), date(2026, 12, 25)}   # 例。実際は国の祝日表を読む

def bizdays_fast(start: date, end: date, holidays=HOLIDAYS) -> int:   # [start, end)
    weeks, rest = divmod((end - start).days, 7)
    wd = start.weekday()
    n = weeks * 5 + sum(1 for i in range(rest) if (wd + i) % 7 < 5)
    return n - sum(1 for h in holidays if start <= h < end and h.weekday() < 5)

どちらも2026年全体で 258、2026年12月21日〜2027年1月4日で 9 を返しました。この 9 にはすでにバグがあります。表に入っているのは 2026年 の元日だけなので、2027年の元日が営業日に数えられています。日本の祝日は振替休日や年ごとの変更もあるので、祝日はコードではなく年ごとのデータとして読み込みます。

実測:ループと計算式

開始日 2020〜2025年、長さ1〜1,094日のランダムな期間 1 万件(シード 42)で、2つの関数は全件で一致しました(assert で確認)。5回の中央値、Python 3.9.6、Apple Silicon Mac(M1 Pro)。

棒グラフ。同じ 1 万件の期間で、1日ずつ回すループは 1812 ミリ秒、週数×5 の計算式は 10.2 ミリ秒だった。
1〜1,094日のランダムな期間 1 万件で営業日を数えた時間(乱数シード 42、5回の中央値、Python 3.9、Apple Silicon Mac M1 Pro)。2つの関数は全件で同じ結果を返し、計算で求める方が約178倍速かった。
関数 1 万件の時間
1日ずつのループ 1,812.0 ms
週数×5+余り 10.2 ms

約 178倍 速くなりました。請求書1枚ならループで十分ですが、1年分の問い合わせ全件の SLA 期限を出すなら計算式を使い、ループはテストの正解として残します。

よくある間違い → 実際に起きたこと → 直し方

間違い 実際の結果 直し方
記念日を date.replace(year=y+1) 2028-02-29 で ValueError calendar.monthrange で丸めるか、2/28 と 3/1 のどちらかを決める
前回の更新日から1か月足す Java:01-31 → 02-28 → 03-28 常に anchor.plusMonths(n)
学年を年度の式で計算 4月1日生まれが1学年ずれる 区切りを (4, 2) にする
aware datetime に timedelta(hours=24) 翌日正午、実際は23時間 UTC に変換して足し、戻す
PHP の modify('+24 hours') 同じく壁時計の結果 add(new DateInterval('PT24H'))
年齢を days // 365 3.04% で誤り 月日を比較する

正直な限界・バージョンのメモ

  • SQLite の floor 修飾子は 3.46 で追加。ここでは 3.51.0 で実行しました。古い SQLite は繰り越ししかしません。
  • 表は各 API がこのバージョンで返した値です。Java・.NET・Swift は丸めを、PHP・JavaScript は範囲外の日の正規化をドキュメントに書いています。
  • Python 標準ライブラリに月の加算はありません。dateutil.relativedelta は Java と同じく丸めますが、サードパーティなのでここでは実行していません。
  • 夏時間の日付はこの Mac の tzdata(2026d)によるものです。規則は政府が変えるので、記憶ではなく tzdata から読みます。
  • JavaScript は jsc だけで実行し、Temporal はありませんでした。

練習問題

1. 2026-08-31 開始の月額サービスがあります。基準日から丸める規則で、次の3回の課金日を挙げてください。PHP の modify('+1 month') を重ねると何日になりますか。

2. Europe/Madrid の利用者に「毎日9時」の通知を 2026-10-24T09:00:00+02:00 から始め、毎回 86,400 秒を足して送っています。10月25日の通知は現地の何時に届きますか。

解答

1. 基準日から丸めると 2026-09-30、2026-10-31、2026-11-30(n = 1, 2, 3 の add_months(anchor, n))。PHP を重ねると 08-31 +1か月が 2026-10-01(本文と同じ実行結果)、続いて 2026-11-01、2026-12-01 で、9月の課金が丸ごと消えます。

2. 8時。マドリードは2026年10月25日に夏時間が終わり(zdump で CEST → CET を確認)、その日は25時間ありました。09:00+02:00 の 86,400 秒後は 08:00+01:00 です。ゾーン上で暦の1日を足します(Java の plusDays(1)、PHP の add(P1D))。

次へ

よくある質問

1月31日の1か月後は何日ですか?

ツールによって違います。Java plusMonths、.NET AddMonths、Swift Calendar、calendar.monthrange を使った Python の関数は 2026-02-28 に丸めました。PHP modify('+1 month')、JavaScript setMonth、Dart、floor なしの SQLite date() は 2026-03-03 に繰り越しました。どちらの規則が必要かを仕様で決め、29日・30日・31日でテストします。

日本には夏時間がないのに、1日=24時間と考えてはいけませんか?

Asia/Tokyo だけなら Java の plusDays(1) は24時間でした。しかし America/New_York では2026年3月7日正午の1日後は23時間後で、Python の timedelta(hours=24) と PHP の modify('+24 hours') は壁時計の正午を返しました。海外ユーザーや海外サーバーが関わる計算では、暦の1日と経過時間を分けて扱います。

年度や学年はどう計算すればよいですか?

年度(4月1日〜3月31日)は月が4以上ならその年、そうでなければ前年です。学年は4月2日〜翌年4月1日生まれで区切るので、月日が (4, 2) 以上ならその年、そうでなければ前年です。4月1日生まれを年度の式で計算すると1学年ずれました。

  • #日付と時刻
  • #中級
  • #日付計算
  • #うるう年
  • #夏時間
  • #Python
  • #PHP
  • #Java
  • #JavaScript

t.laboratory

実際に作って運用しているアプリ・サーバー・サービスで起きた問題と、その解決に使ったコードを記録する技術ブログです。

運営者情報 · アプリ

↑