Home/ Manual/ misc / functions/ hrtime

hrtime

PHP function Edit on GitHub ✎

(PHP 7 >= 7.3.0, PHP 8)

Get the system's high resolution time

Description

hrtime(bool $as_number = false): array|int|float|false

Returns the system's high resolution time, counted from an arbitrary point in time. The delivered timestamp is monotonic and can not be adjusted.

Parameters

as_number: Whether the high resolution time should be returned as array or number.

Return Values

Returns an array of integers in the form [seconds, nanoseconds], if the parameter as_number is false. Otherwise the nanoseconds are returned as int (64bit platforms) or float (32bit platforms). Returns false on failure.

Changelog

Version	Description
8.5.0	On macOS, the implementation now uses `clock_gettime_nsec_np(CLOCK_UPTIME_RAW)` instead of `mach_absolute_time()`.

Examples

hrtime() usage

php

<?php
echo hrtime(true), PHP_EOL;
print_r(hrtime());
?>

The above example will output something similar to:

output

10444739687370679
Array
(
    [0] => 10444739
    [1] => 687464812
)