DateTime::add
date_add
(PHP 5 >= 5.3.0, PHP 7)
DateTime::add -- date_add — 年月日時分秒の値を DateTime オブジェクトに加える
説明
オブジェクト指向型
public DateTime::add
( DateInterval $interval
) : DateTime
手続き型
date_add
( DateTime $object
, DateInterval $interval
) : DateTime
指定した DateInterval オブジェクトを、 指定した DateTime オブジェクトに加えます。
パラメータ
object
- 手続き型のみ: date_create() が返す DateTime オブジェクト。 この関数は、このオブジェクトを変更します。
interval
- DateInterval オブジェクト。
例
例1 DateTime::add() の例
オブジェクト指向型
<?php$date = new DateTime('2000-01-01');$date->add(new DateInterval('P10D'));echo $date->format('Y-m-d') . "\n";?>
手続き型
<?php$date = date_create('2000-01-01');date_add($date, date_interval_create_from_date_string('10 days'));echo date_format($date, 'Y-m-d');?>
上の例の出力は以下となります。
2000-01-11
例2 DateTime::add() の別の例
<?php$date = new DateTime('2000-01-01');$date->add(new DateInterval('PT10H30S'));echo $date->format('Y-m-d H:i:s') . "\n";$date = new DateTime('2000-01-01');$date->add(new DateInterval('P7Y5M4DT4H3M2S'));echo $date->format('Y-m-d H:i:s') . "\n";?>
上の例の出力は以下となります。
2000-01-01 10:00:30 2007-06-05 04:03:02
例3 月を加算するときの注意点
<?php$date = new DateTime('2000-12-31');$interval = new DateInterval('P1M');$date->add($interval);echo $date->format('Y-m-d') . "\n";$date->add($interval);echo $date->format('Y-m-d') . "\n";?>
上の例の出力は以下となります。
2001-01-31 2001-03-03
参考
- DateTime::sub() - 年月日時分秒の値を DateTime オブジェクトから引く
- DateTime::diff() - ふたつの DateTime オブジェクトの差を返す
- DateTime::modify() - タイムスタンプを変更する