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