Time\Duration::fromHours

(PHP 8 >= 8.6.0)

Time\Duration::fromHours — Creates a duration from a number of hours

Description

public static function Time\Duration::fromHours(int $hours): Time\Duration

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

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

+add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top