Home/ Manual/ time / duration/ Time\Duration::fromMicroseconds

Time\Duration::fromMicroseconds

PHP function Edit on GitHub ✎

(PHP 8 >= 8.6.0)

Creates a duration from a number of microseconds

Description

Time\Duration::fromMicroseconds(int $microseconds): Time\Duration

Creates a non-negative duration of microseconds microseconds. The value is normalized into whole seconds and nanoseconds, see the Time\Duration::$seconds and Time\Duration::$nanoseconds properties.

Parameters

microseconds: The number of microseconds. Must be greater than or equal to 0.

Return Values

Returns a new Time\Duration object.

Errors/Exceptions

If microseconds is negative, a ValueError is thrown.

Examples

Time\Duration::fromMicroseconds example

php

<?php
var_dump(\Time\Duration::fromMicroseconds(1_500_000));

The above example will output:

output

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(1)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}