array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.microtime.php', 1 => 'microtime', 2 => 'Retorna o timestamp Unix atual com microssegundos', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Funções de Data/Horário', ), 'prev' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'next' => array ( 0 => 'function.mktime.php', 1 => 'mktime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Retorna 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

Exemplo #1 Cronometrando a execução do script

<?php
$time_start = microtime(true);

// Espera um momento
usleep(10_000);

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

print "Nada foi feito em $time segundo(s).\n";

Exemplo #2 microtime() e REQUEST_TIME_FLOAT

<?php
// Tempo de espera aleatório
usleep(random_int(10_000, 1_000_000));

// 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