日付の計算:月末・うるう年・夏時間の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 |
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日ずつのループ | 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))。
次へ
- 前回:日付講座 3/6:パースと書式、ISO 8601・ロケール・和暦
- 次回:日付講座 5/6:データベースの日時
- 前半:第1回 Unix タイムスタンプと UTC、第2回 タイムゾーンと夏時間、最終回:スケジューリングと時計のずれ
- 「今日」に依存するコードのテスト:時刻・乱数・並行処理で不安定になるテスト
- SQLite の日付関数の土台:SQL の基本:SELECT・WHERE・ORDER BY
- 上の Python の値と型:Python の基本:型とミュータビリティ
- すべての講座:プログラミング学習ロードマップ
よくある質問
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学年ずれました。