microtime

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

microtimeRetorna o timestamp Unix atual com microssegundos

Descrição

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

A função microtime() retorna o timestamp atual com microssegundos. Esta função está disponível apenas em sistemas operacionais que suportam a chamada de sistema gettimeofday().

Para medições de desempenho, é recomendado utilizar hrtime().

Parâmetros

as_float

Se utilizada e definida como true, a função microtime() retornará um float em vez de uma string, como descrito na seção de valores de retorno a seguir.

Valor Retornado

Por padrão, a função microtime() retorna uma string no formato "msec sec", onde sec é o número de segundos desde a época Unix (1 de Janeiro de 1970, 00:00:00 GMT), e msec mensura os microssegundos que se passaram desde sec e também é expressa em segundos, na forma de fração decimal.

Se o parâmetro opcional as_float for definido para true, a função microtime() retorna um float que representa a hora atual em segundos desde a época Unix com precisão de microssegundos.

Exemplos

Example #1 Cronometrando a execução do script

<?php
$time_start = microtime(true);

// Espera um momento
usleep(100);

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

echo "Nada foi feito em $time segundo(s).\n";
?>

Example #2 microtime() e REQUEST_TIME_FLOAT

<?php
// Tempo de espera aleatório
usleep(mt_rand(100, 10000));

// REQUEST_TIME_FLOAT está disponível no array superglobal $_SERVER.
// Ele contém o timestamp do início da requisição com precisão de microssegundos.
$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];

echo "Nada foi feito em $time segundo(s).\n";
?>

Veja Também

  • time() - Retorna o timestamp Unix atual
  • hrtime() - Obtém o tempo de alta resolução do sistema