Time\Duration::add

期間を加算する

説明

public Time\Duration Time\Duration::add(Time\Duration $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