array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.microtime.php', 1 => 'microtime', 2 => 'Возвращает текущую метку времени Unix с микросекундами', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Функции даты и времени', ), 'prev' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'next' => array ( 0 => 'function.mktime.php', 1 => 'mktime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/functions/microtime.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

microtime

(PHP 4, PHP 5, PHP 7, PHP 8)

microtime — Возвращает текущую метку времени Unix с микросекундами

Описание

microtime(bool $as_float = false): string|float

Функция microtime() возвращает текущую метку времени Unix с микросекундами. Функция доступна только на операционных системах, в которых доступен системный вызов функции gettimeofday().

Для измерения производительности вызывают функцию hrtime().

Список параметров

as_float

При передаче значения true функция microtime() вернёт значение float вместо string, как описывает раздел значений возврата.

Возвращаемые значения

По умолчанию функция microtime() возвращает строку (string) в формате "msec sec", где sec — количество секунд в виде десятичной дроби с начала эпохи Unix — 00:00:00 1 января 1970 по времени UTC, а msec — количество микросекунд, которое прошло после sec.

При передаче в параметр as_float значения true функция microtime() вернёт результат в вещественном виде (float) — текущее время в секундах, которое прошло с начала эпохи Unix с точностью до микросекунд.

Примеры

Пример #1 Пример замера времени выполнения скрипта

<?php

$time_start = microtime(true);

// Спим 1/100 секунды
usleep(10_000);

$time_end = microtime(true);
$time = $time_end - $time_start;

print "Скрипт ничего не делал $time секунд\n";

Пример #2 Пример работы функции microtime() с флагом REQUEST_TIME_FLOAT

<?php

// Выбираем время сна случайным образом
usleep(random_int(10_000, 1_000_000));

// В суперглобальном массиве $_SERVER доступно значение REQUEST_TIME_FLOAT.
// Переменная содержит метку времени начала запроса с точностью до микросекунд.
$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];

echo "Скрипт ничего не делал $time секунд\n";

Смотрите также