Time\Duration::multiplyBy
(PHP 8 >= 8.6.0)
Time\Duration::multiplyBy — Multiplies the duration by an integer factor
Description
Returns a duration that is factor times as long as
this duration.
The sign of the duration is preserved.
Parameters
factor
The factor to multiply by.
Must be greater than or equal to 0; a factor of
0 results in a duration of zero.
Return Values
Returns a new Time\Duration object.
Errors/Exceptions
-
If
factoris negative, a ValueError is thrown. -
If the resulting duration exceeds the maximum length of a duration, a Time\TimeException is thrown.
Examples
Example #1 Time\Duration::multiplyBy() example
<?php
var_dump(\Time\Duration::fromMilliseconds(1500)->multiplyBy(4));
try {
\Time\Duration::fromHours(1)->multiplyBy(3_000_000);
} catch (\Time\TimeException $e) {
echo $e->getMessage(), PHP_EOL;
}The above example will output:
object(Time\Duration)#2 (3) {
["seconds"]=>
int(6)
["nanoseconds"]=>
int(0)
["negative"]=>
bool(false)
}
The maximum representable range is 9_223_372_035 seconds (roughly 292 years)
See Also
- Time\Duration::divideBy() - Divides the duration by an integer divisor
- Time\Duration::add() - Adds a duration
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
