関数・クラス解説
DateTime::add
date_add
version:PHP 5 >= 5.3.0, PHP 7 (公式)年月日時分秒の値を DateTime オブジェクトに加える
公式リファレンス
書式
public DateTime::add ( DateInterval $interval ) : DateTime
date_add ( DateTime $object , DateInterval $interval ) : DateTime
説明
オブジェクト指向型
手続き型
指定した DateInterval オブジェクトを、 指定した DateTime オブジェクトに加えます。
パラメータ
- object
- 手続き型のみ: date_create() が返す DateTime オブジェクト。この関数は、このオブジェクトを変更します。
- interval
- DateInterval オブジェクト。
返値
メソッドチェインに使う DateTime オブジェクトを返します。失敗した場合に FALSE を返します。
注意
PHP 5.2 では、かわりに DateTime::modify() を使うことができます。
サンプル
例1 DateTime::add() の例
オブジェクト指向型
$date = new DateTime('2000-01-01');
$date->add(new DateInterval('P10D'));
echo $date->format('Y-m-d') . "\n";
手続き型
$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() の別の例
$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 月を加算するときの注意点
$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
参考
ワード検索
※入力キーワードが、関数名・説明文・タグに含まれるものを検索関数名アルファベット別
最終更新一覧
●stristr
大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却
●stripslashes
バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く
●stripos
大文字小文字を区別せずに文字列が最初に現れる位置を取得する
●stripcslashes
addcslashes() でクォートされた文字列をアンクォートする
●strip_tags
文字列から HTML と PHP のタグを除去して返却
●strcspn
指定した文字が最初に現れる位置を調べる
●strcoll
ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する
●strcmp
2つの文字列を比較し同じか(あるいは大小)を判定する
●strchr
strstr() のエイリアス
●strcasecmp
2つの文字列を比較(大文字小文字を区別せず同じとみなす)
カテゴリー一覧
PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール