|
DateInterval クラスはじめに日付の間隔をあらわします。 格納方式は、固定値 (年、月、日、時など) あるいは相対時刻 (DateTimeImmutable と DateTime のコンストラクタがサポートしている書式) となります。 さらに厳密に言うと、 DateInterval オブジェクトが保持している情報は、 ある date/time オブジェクトから別の date/time オブジェクトに情報を移す手順です。 この過程は必ずしも可逆ではありません。 DateInterval オブジェクトを生成する一般的なやり方は、 2つの date/time オブジェクトの差分を DateTimeInterface::diff 経由で計算することです。 間隔を date/time オブジェクトに加算あるいは減算するとき、 間隔の時刻部分 (時、分、秒、マイクロ秒) がどう適用されるかは、 その間隔がどうやって作られたかによって決まります。 DateInterval::__construct で作られた間隔の場合、時刻部分は経過時間を表します。 一方、 DateInterval::createFromDateString で作られた間隔や DateTimeInterface::diff が返した間隔の場合は、時刻部分が個々のコンポーネントの値をインクリメント/デクリメントします。 日付部分 (年、月、日) は、常に個々のコンポーネントの値をインクリメント/デクリメントします。 したがって、両者の結果が異なるのは、 間隔の時刻部分がタイムゾーンの遷移をまたぐ場合だけです。 日付/時刻 の算術 を参照ください。 日付の間隔を比較する良い方法は定義されていません。 よって、DateInterval のインスタンスは 比較できません。 タイムアウトなど、暦の単位を持たず、長さが一定で比較できる経過時間を扱うには、 代わりに PHP 8.6.0 以降で利用できる Time\Duration を使ってください。 クラス概要
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
bool
$from_string;
public
string
$date_string;
/* メソッド */
public __construct(string
$duration)public static DateInterval createFromDateString(string
$datetime)public string format(string
$format)プロパティ警告
以下に示すプロパティが使えるかどうかは、 PHP のバージョンに依存します。 そして、readonly と見なすべきです。
変更履歴
|