modify('+1 month')は「月数だけを+1して存在しない日付を翌月へ繰り上げる」ため、1月31日が「2月31日=3月3日」に化けます。- 翌月の月初・月末を取得したい場合は
modify('first day of next month')またはmodify('last day of next month')を使います。 - サブスク更新日など「1月31日の1ヶ月後は2月28日(翌月末丸め)」にしたい場合は、対象月の月初から末日を超えないよう丸める関数を実装します。
1. 発生する症状・やりたいこと(前提条件)
月次バッチの集計期間や請求書の発行日、サブスクリプションの次回決済日を計算する際、月末日(29日〜31日)に +1 month や -1 month を実行すると、期待した翌月・前月にならず日付が飛んでしまう現象が発生します。
- 1月31日に
modify('+1 month')を実行すると「2月28日」ではなく「3月3日」になる - 3月31日の前月(
-1 month)を取得したつもりが、2月を飛び越えて「3月3日」のままになる - どんな日付を基準にしても、確実に「翌月の月初・月末」や「月末丸め付きの1ヶ月後」を算出したい
// ❌ 実際に起きる日付ずれ現象(平年の場合)
2026-01-31 に '+1 month' → 2026-03-03 (2月がスキップされる!)
2026-03-31 に '+1 month' → 2026-05-01 (4月がスキップされる!)
// ⭕ 実務で期待する計算結果
翌月の月初を取得したい → 2026-02-01
翌月の月末を取得したい → 2026-02-28
翌月の同日(月末丸め) → 2026-02-28(1月15日なら 2026-02-15)
2. ❌ やりがちなNGコード vs ⭕ 実務で使える正解コード
<?php
$baseDate = new DateTimeImmutable('2026-01-31');
// NG1: 単純に +1 month すると「2026-02-31」と解釈され、3日分が3月へ繰り上がる
$nextMonth = $baseDate->modify('+1 month');
echo $nextMonth->format('Y-m-d'); // 出力: 2026-03-03
// NG2: DateInterval('P1M') を使っても内部の繰り上がり仕様はまったく同じ
$nextByInterval = $baseDate->add(new DateInterval('P1M'));
echo $nextByInterval->format('Y-m-d'); // 出力: 2026-03-03
PHPの DateTime / DateTimeImmutable は、+1 month を実行すると内部的に「月番号だけを+1(1月31日 → 2月31日)」し、その後に存在しない日付のオーバーフロー補正(28日+3日=3月3日)を行うため、2月や4月といった日数の少ない月が丸ごとスキップされてしまいます。
<?php
declare(strict_types=1);
/**
* 日付の繰り上がりを防ぎ、月末日で安全に丸めて月数を加算する
* 例: 2026-01-31 の1ヶ月後 → 2026-02-28 / 2026-01-15 の1ヶ月後 → 2026-02-15
*/
function addMonthsClamped(DateTimeImmutable $date, int $months): DateTimeImmutable
{
$sign = $months >= 0 ? '+' : '';
// 1. まず「対象月の1日」を確実に取得して月飛びを防ぐ
$firstDayOfTarget = $date->modify("first day of {$sign}{$months} month");
// 2. 元の「日」と「対象月の末日(t)」の小さい方を採用して丸める
$originalDay = (int) $date->format('j');
$daysInTargetMonth = (int) $firstDayOfTarget->format('t');
$targetDay = min($originalDay, $daysInTargetMonth);
return $firstDayOfTarget->setDate(
(int) $firstDayOfTarget->format('Y'),
(int) $firstDayOfTarget->format('n'),
$targetDay
);
}
$baseDate = new DateTimeImmutable('2026-01-31');
// パターンA: 翌月の月初・月末が欲しい場合(相対フォーマットで一発解決)
$firstDay = $baseDate->modify('first day of next month')->format('Y-m-d'); // 2026-02-01
$lastDay = $baseDate->modify('last day of next month')->format('Y-m-d'); // 2026-02-28
// パターンB: サブスク更新日など「同日(なければ月末日)」が欲しい場合
$nextBilling = addMonthsClamped($baseDate, 1)->format('Y-m-d'); // 2026-02-28
3. 仕様・使い分けの比較早見表
基準日が 2026-01-31 のときに、各メソッドや相対フォーマットが返す日付と用途の違いを整理しました。
| 指定方法 / 関数 | 2026-01-31 に対する結果 |
特徴・挙動 | おすすめな場面 |
|---|---|---|---|
modify('+1 month')add(new DateInterval('P1M')) |
2026-03-03 ❌ |
存在しない日(2月31日)が翌月へ繰り上がる | 原則非推奨(月初1日〜28日であることが保証されている場合のみ) |
modify('first day of next month') |
2026-02-01 ⭕ |
基準日が何日であっても確実に翌月1日を返す | 月次レポートやカレンダーの「翌月開始日」を取得したいとき |
modify('last day of next month') |
2026-02-28 ⭕ |
うるう年も自動判定して確実に翌月末日を返す | 請求書の支払期限(翌月末払い)などを算出したいとき |
modify('first day of +3 month') |
2026-04-01 ⭕ |
Nヶ月後の月初(または last day of で月末)を返す |
2ヶ月以上先・過去の月初や月末を取得したいとき |
addMonthsClamped()(自作関数)Laravel: addMonthsNoOverflow() |
2026-02-28 ⭕(15日なら 02-15) |
通常日は同日を維持し、月末超過時のみ末日に丸める | 月額サブスクの次回決済日・契約更新日の算出 |
4. 実務でハマりやすい3つの注意点
従来の DateTime クラスはミュータブル(可変)なため、$end = $start->modify('+1 month') と書くと元の $start 自身まで書き換わってしまいます。開始日と終了日が同じ値になる重大バグを防ぐため、実務では必ず新しいインスタンスを返す DateTimeImmutable を標準にしてください。
new DateTimeImmutable('2026-01-31 14:30:00') に対して modify('first day of next month') を実行すると、結果は 2026-02-01 14:30:00 になります。DBの期間検索(WHERE created_at >= ?)に使う場合は、->setTime(0, 0, 0) をチェインするか modify('first day of next month midnight') で時刻をリセットしましょう。
月末バグは月単位だけでなく、うるう年の 2024-02-29 に modify('+1 year') を実行した際にも 2025-03-01 へ繰り上がる形で発生します。年額プランの更新日などを計算する場合も、+1 year ではなく上記の addMonthsClamped($date, 12) を使って 2025-02-28 に丸めるのが安全です。
5. よくある質問(FAQ)
Q. strtotime('+1 month') を使った場合も月末のずれは発生しますか?
はい、まったく同じように発生します。strtotime() と DateTimeImmutable::modify() は内部で同じ日付解析エンジンを使用しているため、strtotime('first day of next month', $timestamp) のように相対フォーマットを指定して回避してください。
Q. 翌月ではなく「2ヶ月後」「3ヶ月前」の月末を取得したい場合はどう書きますか?
next month の部分を +2 month や -3 month に置き換えて、$date->modify('last day of +2 month') または $date->modify('last day of -3 month') と記述すれば、任意の月数だけ移動した先の月末日を安全に取得できます。
Q. Laravel(Carbon)を使っている場合、月末バグを防ぐ標準メソッドはありますか?
Laravelに含まれる Carbon(および CarbonImmutable)には、月末の繰り上がりを自動で防ぐ addMonthNoOverflow() / addMonthsNoOverflow(int $months) や subMonthNoOverflow() が標準用意されています。Laravel環境では addMonth() ではなく NoOverflow 系メソッドを使うのがベストプラクティスです。