PHP | función time_sleep_until( )

La función time_sleep_until() en PHP es una función incorporada que se usa para retrasar la ejecución del script actual hasta el tiempo especificado.
La función time_sleep_until( ) acepta la marca de tiempo como un parámetro y esta marca de tiempo indica cuándo debe activarse el script.
La función time_sleep_until( ) devuelve VERDADERO en caso de éxito o FALSO en caso de error.

Sintaxis:

time_sleep_until(timestamp)

Parámetros usados: La función time_sleep_until() en PHP acepta un parámetro timestamp . Es un parámetro obligatorio que especifica el tiempo de activación.

Valor devuelto: Devuelve VERDADERO en caso de éxito o FALSO en caso de fallo.

Errores y excepciones :

1. Si la marca de tiempo especificada está en el pasado, esta función generará una E_WARNING.
2. Todas las señales se entregan después de que se activa el script.
3. Esta función arroja un error si el número especificado es negativo.

Ejemplos:

Input : echo date('h:i:s');
        time_sleep_until(time()+5);
        echo date('h:i:s'); 
Output: 07:23:26
        07:23:31

Input : echo date('h:i:s');
        time_sleep_until(time()+ rand(1, 3));
        echo date('h:i:s');
Output : 07:21:55
         07:21:57

Los siguientes programas ilustran la función time_sleep_until():

Programa 1 :

<?php
// displaying time
echo date('h:i:s');
  
// delaying execution of script for 5 seconds
time_sleep_until(time()+5);
  
// displaying time again
echo ("\n");
echo date('h:i:s'); 
?>

06:50:04
06:50:08

Programa 2 :

<?php
// displaying time
echo date('h:i:s');
  
// using rand() function to randomly choose a
// value and delay execution of the script
time_sleep_until(time()+ rand(1, 3));
  
// displaying time again
echo ("\n");
echo date('h:i:s'); 
?>

06:50:14
06:50:15

Programa 3 :

<?php
  
// delaying execution of script with negative time
time_sleep_until(time()-2);
  
// displaying time again
echo ("\n");
echo date('h:i:s'); 
?>

false

Referencia: http://php.net/manual/en/function.time-sleep-until.php