Time\Duration::divideBy

期間を整数で割る

説明

public Time\Duration Time\Duration::divideBy(int $divisor)

この期間を divisor で割った期間を返します。 1 ナノ秒未満の端数は切り捨てられるため、結果は 0 に近い方向に丸められます。 符号は維持されます。

パラメータ

divisor
除数。 0 より大きくなければなりません。

戻り値

新しい Time\Duration オブジェクトを返します。

エラー / 例外

  • divisor が負の場合、 ValueError がスローされます。
  • divisor が 0 の場合、 DivisionByZeroError がスローされます。

例

例1 Time\Duration::divideBy の例

<?php
// 1 ナノ秒未満の端数は切り捨てられます。
var_dump(\Time\Duration::fromSeconds(10)->divideBy(3)->multiplyBy(3));

try {
    \Time\Duration::fromSeconds(10)->divideBy(0);
} catch (DivisionByZeroError $e) {
    echo $e->getMessage(), PHP_EOL;
}

上の例の出力は以下となります。

object(Time\Duration)#3 (3) {
  ["seconds"]=>
  int(9)
  ["nanoseconds"]=>
  int(999999999)
  ["negative"]=>
  bool(false)
}
Division by zero

参考

  • Time\Duration::multiplyBy
  • intdiv