|
Time\Duration クラスはじめにタイムアウトや、ストップウォッチで計った時間のような、 長さが一定の経過時間をナノ秒の精度で表します。 期間は、負でない整数の秒数 (Time\Duration::$seconds)、1 秒未満のナノ秒数 (Time\Duration::$nanoseconds)、符号 (Time\Duration::$negative) で構成されます。
日、月、年などの暦の単位は一定の秒数に対応しないため、
Time\Duration は
DateInterval とは異なり、これらの単位を持ちません。
DST (夏時間) の移行をまたぐと 1 日は 23 時間や 25 時間になることがあり、
月の長さもまちまちです。
そのため、期間の作成に使える最大の単位は時間です。
DateTimeImmutable オブジェクトで暦に基づいて計算するには
DateInterval を、
I/O ポーリング API の
このクラスのオブジェクトは不変です。
作成には
2 つの期間は、
比較演算子
(
期間の最大長は、64 ビットプラットフォームでは
クラス概要Time
final
readonly
Duration
/* プロパティ */
public
readonly
int
$seconds;
public
readonly
int
$nanoseconds;
public
readonly
bool
$negative;
/* メソッド */
private Time\Duration::__construct()
public Time\Duration Time\Duration::absolute()
public Time\Duration Time\Duration::add(Time\Duration
$duration)public static int Time\Duration::compare(Time\Duration
$a, Time\Duration $b)public Time\Duration Time\Duration::divideBy(int
$divisor)public static Time\Duration Time\Duration::fromHours(int
$hours)public static Time\Duration Time\Duration::fromIso8601DurationString(string
$specification)public static Time\Duration Time\Duration::fromMicroseconds(int
$microseconds)public static Time\Duration Time\Duration::fromMilliseconds(int
$milliseconds)public static Time\Duration Time\Duration::fromMinutes(int
$minutes)public static Time\Duration Time\Duration::fromNanoseconds(int
$nanoseconds)public static Time\Duration Time\Duration::fromSeconds(int
$seconds, int $nanoseconds = 0)public Time\Duration Time\Duration::multiplyBy(int
$factor)public Time\Duration Time\Duration::negate()
public Time\Duration Time\Duration::sub(Time\Duration
$duration)public void Time\Duration::__unserialize(array
$data)プロパティ
例例1 期間の作成と足し合わせ 上の例の出力は以下となります。
object(Time\Duration)#3 (3) {
["seconds"]=>
int(61)
["nanoseconds"]=>
int(500000000)
["negative"]=>
bool(false)
}
61.500000000 seconds
例2 期間の比較 上の例の出力は以下となります。 0.250000000 5.000000000 120.000000000 bool(true) bool(true) 参考
|