PHP DateTime::modifyメソッドの使い方

  • PHP
  • メソッド
最終更新日:

この記事のポイント

PHPの日時操作において、DateTime::modifyメソッドは非常に強力で使いやすいツールです。以下のポイントを押さえることで、効率的な日時処理が可能になります。

  • 相対的な日時指定により柔軟な時間計算が可能
  • 文字列形式の指定で直感的な日時操作を実現
  • 複雑な日時計算もシンプルなコードで処理可能

これらの特徴を理解することで、さまざまな開発シーンで活用できるようになるでしょう。

目次

DateTime::modifyメソッドとは？

DateTime::modifyメソッドは、DateTimeオブジェクトの日時を相対的な指定で変更するメソッドです。このメソッドを使用することで、現在の日時を基準として、日、週、月、年などの単位で時間を加算・減算できます。

例えば、今日から1週間後、3か月前、来年の同じ日などを簡単に計算できます。文字列形式で直感的に指定できるため、複雑な日時計算も読みやすいコードで実現できる特徴があります。

【関連】
PHPをもっと詳しく学ぶならpaizaラーニング

基本構文

DateTime::modifyメソッドの基本的な構文を理解することで、さまざまな日時操作が可能になります。メソッドは文字列形式のパラメータを受け取り、相対的な時間指定を行います。

<?php $date = new DateTime(); $date->modify('+1 day'); echo $date->format('Y-m-d'); ?>







出力結果（例）
2025-08-15
※出力結果は実行した時刻により変動する場合があります。また、時刻はUTC形式で計算されるため、日本時間での計算結果と異なる場合があります。以後のコードも同様です。

  
<?php
$date = new DateTime('2025-01-15');
$date->modify('-2 weeks +3 days');
echo $date->format('Y-m-d');
?>

  


  







出力結果
2025-01-04
実用例
実際の開発現場でよく使われるDateTime::modifyメソッドの活用例を紹介します。各例では具体的なシチュエーションを想定し、実用性の高いサンプルコードを掲載しています。これらの例を参考にすることで、日常的な開発業務で遭遇するさまざまな日時計算の課題を解決できるでしょう。
コード例は実行可能な形で提供し、出力結果も併せて確認できます。
日付を1週間後に変更
イベントの開催日から次回開催予定日を自動計算する場面で使われる例です。

  
<?php
$eventDate = new DateTime('2025-01-15');
$nextEvent = clone $eventDate;
$nextEvent->modify('+1 week');
echo 'ネコの餌やり: ' . $nextEvent->format('Y-m-d');
?>

  


  







出力結果
ネコの餌やり: 2025-01-22
月末日を取得
請求書の締め日や給与計算など、月末日の取得が必要な業務で活用する例です。

  
<?php
$date = new DateTime('2025-02-15');
$date->modify('last day of this month');
echo 'イヌの健康診断: ' . $date->format('Y-m-d');
?>

  


  







出力結果
イヌの健康診断: 2025-02-28
営業日を計算
土日を除いた営業日の計算例です。業務システムでよく必要とされる機能です。

  
<?php
$date = new DateTime('2025-01-15');
$date->modify('next monday');
echo 'ウサギの健康診断: ' . $date->format('Y-m-d');
?>

  


  







出力結果
ウサギの健康診断: 2025-01-20
年齢計算
誕生日から現在の年齢を計算する例です。

  
<?php
$birthDate = new DateTime('2020-01-15');
$today = new DateTime();
$age = $birthDate->diff($today);
echo 'ハムスターの年齢: ' . $age->y . '歳';
?>

  


  







出力結果
ハムスターの年齢: 5歳
diffメソッドと組み合わせることで、正確な年齢計算が可能になります。会員管理システムなどで重宝する機能です。
四半期の開始日を取得
ビジネス分析やレポート作成で四半期の期間を特定する例です。

  
<?php
$date = new DateTime('2025-07-15');
$quarterStart = new DateTime($date->format('Y') . '-04-01');
echo 'リスの収穫期: ' . $quarterStart->format('Y-m-d');
?>

  


  







出力結果
リスの収穫期: 2025-04-01
年度の四半期開始日を動的に計算することで、期間指定のクエリ生成などに活用できます。
時間を30分前に戻す
会議のリマインダーやアラート機能の例です。指定時刻より前の時間を計算する場合に使用します。

  
<?php
$meetingTime = new DateTime('2025-01-15 14:00:00');
$reminderTime = clone $meetingTime;
$reminderTime->modify('-30 minutes');
echo 'クマの昼寝: ' . $reminderTime->format('Y-m-d H:i:s');
?>

  


  







出力結果
クマの昼寝: 2025-01-15 13:30:00
時間単位での計算も簡単に行えるため、タイムスケジュール管理アプリケーションで重宝します。
来月の第1月曜日を取得
定期会議の日程調整や月次レポートの作成スケジュールを自動化する例です。

  
<?php
$date = new DateTime('2025-01-15');
$date->modify('first monday of next month');
echo 'キツネの生態についてのレポート: ' . $date->format('Y-m-d');
?>

  


  







出力結果
キツネの会合: 2025-02-03
複雑な条件指定も文字列で直感的に記述できるため、保守性の高いコードが書けます。
2年後の同じ日を取得
契約更新日や保証期間の満了日など、長期間の日付計算で使用する例です。

  
<?php
$contractDate = new DateTime('2025-01-15');
$renewalDate = clone $contractDate;
$renewalDate->modify('+2 years');
echo 'パンダの契約更新: ' . $renewalDate->format('Y-m-d');
?>

  


  







出力結果
パンダの契約更新: 2027-01-15
年単位での計算もうるう年を考慮して正確に行われるため、長期契約管理システムで安心して使用できます。
まとめ
DateTime::modifyメソッドは、直感的で柔軟な日時操作を可能にする強力なツールです。文字列形式での指定により、複雑な日時計算も読みやすいコードで実現できます。
DateTime::modifyメソッドの活躍する場面
    

  • スケジュール管理システムでの日程自動計算
    • 

  • 業務システムでの締め日や期限日の算出処理
    • 

  • イベント管理アプリでの定期開催日程の生成
    • 

重要なポイント
    

  • 元オブジェクトを変更するためclone使用を推奨
    • 

  • 文字列指定で直感的な日時操作が可能
    • 

  • うるう年や月末日も自動的に正しく計算
    • 

このメソッドをマスターすることで、日時に関連するさまざまな業務処理を効率的に実装できるようになります。実際のプロジェクトでも積極的に活用して、保守性の高いコードを心がけましょう。
レベルを更に上げたい方はpaizaプログラミングスキルチェックへ





























  1. paizaラーニングトップ
  2. リファレンス
  3. PHPのリファレンス記事一覧
  4. PHP DateTime::modifyメソッドの使い方