date
En esta página
date
Da formato a una marca de tiempo de Unix (Unix timestamp)
Descripción#
date(string $format, [int $timestamp]): string
```php
Devuelve una cadena formateada según el formato indicado usando el integer `timestamp` (Unix timestamp) dado, o el momento actual si no se da una marca de tiempo. En otras palabras, `timestamp` es opcional y por defecto es el valor de `time`.
> [!WARNING]
> Las marcas de tiempo de Unix no manejan zonas horarias. Usa la clase `DateTimeImmutable`, y su método DateTimeInterface::format para formatear fecha/hora incluyendo la información de zona horaria.
## Parámetros
`format`
Formato aceptado por DateTimeInterface::format.
> [!NOTE]
> `date` generará siempre `000000` como microsegundos ya que toma un tipo `int` como parámetro, mientras que DateTimeInterface::format soporta microsegundos, si el objeto del tipo DateTimeInterface es creado con microsegundos.
`timestamp`
El parámetro opcional `timestamp` es un `int` timestamp Unix que por defecto es la hora local actual si `timestamp` se omite o es `null`. En otras palabras, por defecto toma el valor de `time`.
## Valores devueltos
Devuelve una cadena de fecha formateada.
## Errores/Excepciones
Cada llamada a una función de fecha/hora generará un diagnóstico de tipo `E_WARNING` si la zona horaria no es válida. Ver también `date_default_timezone_set`
## Historial de cambios
| Versión | Descripción |
|---------|--------------------------------|
| 8.0.0 | `timestamp` ahora es nullable. |
## Ejemplos
Ejemplos de `date`
Puede prevenir que un carácter reconocido en la cadena de formato sea expandido escapándolo con una barra invertida precedente. Si el carácter con una barra invertida es ya una secuencia especial, necesitará escapar también la barra invertida.
Escapando caracteres en `date`
Algunos ejemplos de formatear `date`. Observe que debería escapar cualesquiera otros caracteres, ya que cualquiera que tenga actualmente un significado especial producirá resultados no deseados, y a otros caracteres se les pueden asignar significado en futuras versiones de PHP. Cuando se escapa un carácter, asegúrese de usar comillas simples para prevenir que caracteres como \n se conviertan en nuevas líneas.
Dando formato con `date`