sleep

sleep(int $seconds): int
```php

Detiene la ejecución del programa durante `seconds` segundos.

> [!NOTE]
> Para retrasar la ejecución de un programa durante una fracción de segundo, utilice la función `usleep` ya que la función `sleep` espera un `int`. Por ejemplo, `sleep(0.25)` retrasará la ejecución del programa durante `0` segundos.

## Parámetros

`seconds`  
El tiempo de detención, en número de segundos (debe ser superior o igual a `0`).

## Valores devueltos

Retorna cero en caso de éxito.

Si la llamada es interrumpida por una señal, la función `sleep` retornará un valor diferente de cero. En Windows, el valor será siempre `192` (el valor de la constante `WAIT_IO_COMPLETION` de la API de Windows). En otras plataformas, el valor retornado será el número de segundos restantes para la función `sleep`.

## Errores/Excepciones

Se lanza una `ValueError` si el número `seconds` especificado es negativo.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | La función lanza una `ValueError` si `seconds` es negativo; anteriormente, se generaba un error de nivel `E_WARNING` y la función retornaba `false`. |

## Ejemplos

Ejemplo con `sleep`

05:31:23
05:31:33