Php/docs/class.dateinterval

提供:Dev Guides
< Php
移動先:案内検索

(PHP 5 >= 5.3.0, PHP 7)

はじめに

日付の間隔をあらわします。

格納方式は、固定値 (年、月、日、時など) あるいは相対時刻 (DateTime のコンストラクタがサポートしている書式) となります。

さらに厳密に言うと、 DateInterval オブジェクトが保持している情報は、 ある date/time オブジェクトから別の date/time オブジェクトに情報を移す手順です。 この過程は必ずしも可逆ではありません。

DateInterval オブジェクトを生成する一般的なやり方は、 2つの date/time オブジェクトの差分を DateTimeInterface::diff() 経由で計算することです。


クラス概要


DateInterval {

/* プロパティ */

public int $y

public int $m

public int $d

public int $h

public int $i

public int $s

public float $f

public int $invert

public mixed $days

/* メソッド */

public __construct ( string $duration )

public static createFromDateString ( string $datetime ) : DateInterval

public format ( string $format ) : string

}

プロパティ

y

年。

m

月。

d

日。

h

時間。

i

分。

s

秒。

f

マイクロ秒。1秒の100万分の1です。

invert

間隔が負の数になっている場合は 1、そうでない場合は 0DateInterval::format() を参照ください。

days

DateTime::diff() で作られた DateInterval オブジェクトの場合は、開始日と終了日の間の日数。 それ以外の場合は daysfalse となります。

PHP 5.4.20/5.5.4 より前のバージョンでは、 false ではなく -99999 となっていました。


変更履歴

バージョン 説明
7.1.0 f プロパティが追加されました


目次