PHP Manual»Fonctions Date/Heure»microtime

microtime

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

microtime — Retourne le timestamp UNIX actuel avec les microsecondes

Description

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

microtime() retourne le timestamp Unix, avec les microsecondes. Cette fonction est uniquement disponible sur les systèmes qui supportent la fonction gettimeofday().

Pour mesurer les performances, l'utilisation de hrtime() est recommandée.

Liste de paramètres

as_float: Si utilisé et défini à true, microtime() retournera un nombre à virgule flottante au lieu d'une string, tel que décrit dans la section des valeurs retournées ci-dessous.

Valeurs de retour

Par défaut, microtime() retourne une string au format "msec sec", où sec est le nombre de secondes depuis l'époque Unix (1 janvier 1970, 00:00:00 GMT), et msec est le nombre de microsecondes qui se sont écoulées depuis sec, exprimé en secondes sous forme de fraction décimale.

Si as_float est défini à true, alors microtime() retourne un nombre à virgule flottante, qui représente le temps courant, en secondes, depuis l'époque Unix, précis à la microseconde près.

Exemples

Exemple #1 Durée d'exécution d'un script en PHP

<?php
$time_start = microtime(true);

// Attend pendant un moment
usleep(10_000);

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

print "Ne rien faire pendant $time secondes\n";

Exemple #2 Exemple avec microtime() et REQUEST_TIME_FLOAT

<?php
// Durée d'attente aléatoire
usleep(random_int(10_000, 1_000_000));

// REQUEST_TIME_FLOAT est disponible dans le tableau superglobal $_SERVER.
// Il contient le timestamp du début de la requête, avec une précision à la microseconde.
$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];

echo "Ne rien faire pendant $time secondes\n";

Voir aussi

time() - Retourne l'horodatage UNIX actuel
hrtime() - Renvoie le temps de haute résolution du système