(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
、そうでない場合は0
。 DateInterval::format() を参照ください。days
DateTime::diff() で作られた DateInterval オブジェクトの場合は、開始日と終了日の間の日数。 それ以外の場合は
days
はfalse
となります。PHP 5.4.20/5.5.4 より前のバージョンでは、
false
ではなく -99999 となっていました。
変更履歴
バージョン | 説明 |
---|---|
7.1.0 | f プロパティが追加されました
|
目次
- DateInterval::__construct — 新しい DateInterval オブジェクトを作成する
- DateInterval::createFromDateString — 相対指定文字列から DateInterval を作成する
- DateInterval::format — 間隔をフォーマットする
/* プロパティ */