Time\Duration::fromHours
(PHP 8 >= 8.6.0)
Time\Duration::fromHours — Creates a duration from a number of hours
Description
Creates a non-negative duration of hours hours.
The value is normalized into whole seconds and nanoseconds, see the
Time\Duration::$seconds and
Time\Duration::$nanoseconds properties.
Parameters
hours
The number of hours.
Must be greater than or equal to 0.
Return Values
Returns a new Time\Duration object.
Errors/Exceptions
-
If
hoursis 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::fromHours() example
<?php
var_dump(\Time\Duration::fromHours(24));
try {
\Time\Duration::fromHours(PHP_INT_MAX);
} catch (\Time\TimeException $e) {
echo $e->getMessage(), PHP_EOL;
}The above example will output:
object(Time\Duration)#1 (3) {
["seconds"]=>
int(86400)
["nanoseconds"]=>
int(0)
["negative"]=>
bool(false)
}
The maximum representable range is 9_223_372_035 seconds (roughly 292 years)
See Also
- Time\Duration::fromSeconds() - Creates a duration from a number of seconds and nanoseconds
- Time\Duration::fromMinutes() - Creates a duration from a number of minutes
- Time\Duration::fromIso8601DurationString() - Creates a duration from an ISO 8601 duration string
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
