Time\Duration::add
期間を加算する
説明
public Time\Duration Time\Duration::add(Time\Duration $duration)
この期間と duration の和を返します。
どちらの期間の符号も考慮されるため、正の期間に負の期間を加算すると、元の期間より短くなります。
戻り値
新しい Time\Duration オブジェクトを返します。
エラー / 例外
-
結果が
期間の最大長
を超える場合、Time\TimeException
がスローされます。
例
例1 Time\Duration::add の例
<?php
$total = \Time\Duration::fromMinutes(1)
->add(\Time\Duration::fromSeconds(30))
->add(\Time\Duration::fromMilliseconds(500));
var_dump($total);
// 負の期間を加算すると、減算になります。
$result = \Time\Duration::fromSeconds(10)
->add(\Time\Duration::fromSeconds(4)->negate());
var_dump($result->seconds);
object(Time\Duration)#2 (3) {
["seconds"]=>
int(90)
["nanoseconds"]=>
int(500000000)
["negative"]=>
bool(false)
}
int(6)
参考
- Time\Duration::sub
- Time\Duration::multiplyBy