strftime

#[\Deprecated] strftime(string $format, [int $timestamp]): string
```php

Formatea una fecha y/o una hora según la localización local. Los nombres de los meses, de los días de la semana pero también de otras cadenas dependientes de la localización, respetarán la localización actual definida por la función `setlocale`.

> [!WARNING]
> Es posible que no todos los especificadores de conversión sean compatibles con su biblioteca C, en cuyo caso no serán compatibles con `strftime` de PHP. Además, no todas las plataformas admiten marcas de tiempo negativas, por lo que su rango de fechas puede estar limitado a fechas no anteriores a la época Unix. Esto significa que `%e`, `%T`, `%R` y `%D` (y puede que otros) y las fechas anteriores al `1 de Enero de 1970` no funcionarán bajo Windows, en algunas distribuciones de Linux, y algunos otros sistemas operativos. Para Windows, una lista completa de las opciones de conversión está disponible en el [sitio de MSDN](http://msdn.microsoft.com/en-us/library/fe06s4ak.aspx). Utilice en su lugar el método IntlDateFormatter::format.

## Parámetros

`format`  
| `format` | Descripción | Ejemplo de valores devueltos |
|----|----|----|
| *Día* | --- | --- |
| `%a` | Nombre abreviado del día de la semana | De `Sun` a `Sat` |
| `%A` | Nombre completo del día de la semana | De `Sunday` a `Saturday` |
| `%d` | Día del mes en formato numérico, con 2 dígitos (con el cero inicial) | De `01` a `31` |
| `%e` | Día del mes, con un espacio precediendo al primer dígito. La implementación de Windows es diferente, véase más abajo para más información. | De `1` a `31` |
| `%j` | Día del año, con 3 dígitos con cero inicial | `001` a `366` |
| `%u` | Representación ISO-8601 del día de la semana | De `1` (para Lunes) a `7` (para Domingo) |
| `%w` | Representación numérica del día de la semana | De `0` (para Domingo) a `6` (para Sábado) |
| *Semana* | --- | --- |
| `%U` | Número de la semana del año dado, comenzando por el primer Lunes como primera semana | `13` (para la 13ª semana completa del año) |
| `%V` | Número de la semana del año, siguiendo la norma ISO-8601:1988, comenzando como primera semana, la semana del año que contiene al menos 4 días, y donde Lunes es el inicio de la semana | De `01` a `53` (donde 53 cuenta como semana de solapamiento) |
| `%W` | Una representación numérica de la semana del año, comenzando por el primer Lunes de la primera semana | `46` (para la 46ª semana de la semana comenzando por un Lunes) |
| *Mes* | --- | --- |
| `%b` | Nombre del mes, abreviado, según la localización | De `Jan` a `Dec` |
| `%B` | Nombre completo del mes, según la localización | De `January` a `December` |
| `%h` | Nombre del mes abreviado, según la localización (alias de %b) | De `Jan` a `Dec` |
| `%m` | Mes, con 2 dígitos | De `01` (para Enero) a `12` (para Diciembre) |
| *Año* | --- | --- |
| `%C` | Representación, con 2 dígitos, del siglo (año dividido por 100, reducido a un entero) | `19` para el siglo 20 |
| `%g` | Representación, con 2 dígitos, del año, compatible con los estándares ISO-8601:1988 (véase %V) | Ejemplo: `09` para la semana del 6 de enero de 2009 |
| `%G` | La versión completa de 4 dígitos de %g | Ejemplo: `2009` para la semana del 3 de enero de 2009 |
| `%y` | El año, con 2 dígitos | Ejemplo: `09` para 2009, `79` para 1979 |
| `%Y` | El año, con 4 dígitos | Ejemplo: `2038` |
| *Hora* | --- | --- |
| `%H` | La hora, con 2 dígitos, en formato 24 horas | De `00` a `23` |
| `%k` | La hora en formato 24 horas, con un espacio precediendo a un solo dígito | De `0` a `23` |
| `%I` | Hora, con 2 dígitos, en formato 12 horas | De `01` a `12` |
| `%l` ('L' minúscula) | Hora, en formato 12 horas, con un espacio precediendo a un solo dígito | De `1` a `12` |
| `%M` | Minuto, con 2 dígitos | De `00` a `59` |
| `%p` | 'AM' o 'PM', en mayúsculas, basado en la hora proporcionada | Ejemplo: `AM` para 00:31, `PM` para 22:23. El resultado exacto depende del sistema operativo, y pueden devolver también variantes en minúsculas, o variantes con puntos (como `a.m.`). |
| `%P` | 'am' o 'pm', en minúsculas, basado en la hora proporcionada | Ejemplo: `am` para 00:31, `pm` para 22:23. No soportado por todos los sistemas operativos. |
| `%r` | Idéntico a "%I:%M:%S %p" | Ejemplo: `09:34:17 PM` para 21:34:17 |
| `%R` | Idéntico a "`%H:%M`" | Ejemplo: `00:35` para 12:35 AM, `16:44` para 4:44 PM |
| `%S` | Segundo, con 2 dígitos | De `00` a `59` |
| `%T` | Idéntico a "`%H:%M:%S`" | Ejemplo: `21:34:17` para 09:34:17 PM |
| `%X` | Representación de la hora, basada en la localización, sin la fecha | Ejemplo: `03:59:16` o `15:59:16` |
| `%z` | El desplazamiento horario. No implementado tal como se describe en Windows. Ver más abajo para más información. | Ejemplo: `-0500` para la hora del este de EE.UU. |
| `%Z` | La abreviación del desplazamiento horario. No implementado tal como se describe en Windows. Ver más abajo para más información. | Ejemplo: `EST` para la hora del este |
| *Hora y fecha* | --- | --- |
| `%c` | Fecha y hora preferidas, basadas en la localización | Ejemplo: `Tue Feb 5 00:45:10 2009` para el 5 de febrero de 2009 a las 12:45:10 AM |
| `%D` | Idéntico a "`%m/%d/%y`" | Ejemplo: `02/05/09` para el 5 de febrero de 2009 |
| `%F` | Idéntico a "`%Y-%m-%d`" (usado habitualmente por las bases de datos) | Ejemplo: `2009-02-05` para el 5 de febrero de 2009 |
| `%s` | Timestamp de la época Unix (idéntico a la función `time`) | Ejemplo: `305815200` para el 10 de septiembre de 1979 08:40:00 AM |
| `%x` | Representación preferida de la fecha, basada en la localización, sin la hora | Ejemplo: `02/05/09` para el 5 de febrero de 2009 |
| *Varios* | --- | --- |
| `%n` | Una nueva línea ("\n") | --- |
| `%t` | Una tabulación ("\t") | --- |
| `%%` | El carácter de porcentaje ("`%`") | --- |

Los siguientes caracteres son reconocidos en el argumento `format`

> [!WARNING]
> A diferencia de la norma `ISO-9899:1999`, Sun Solaris comienza con el Domingo a 1. También, el formato `%u` no funcionará tal como se describe en este manual.

> [!WARNING]
> *Solo Windows:*
>
> El modificador `%e` no es soportado bajo Windows. Para calcular el valor, el modificador `%#d` puede ser utilizado en su lugar. El ejemplo de abajo ilustra la manera de escribir un código multiplataforma.
>
> Los modificadores `%z` y `%Z` devuelven ambos el nombre de la zona horaria en lugar del desplazamiento o de la abreviación.

> [!WARNING]
> *Solo macOS y musl:* El modificador `%P` no es soportado por la implementación de esta función bajo macOS.

`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 `string` formateada según el argumento `format` dado, utilizando el argumento `timestamp` o la fecha local actual si no se proporciona ningún timestamp. Los nombres de los meses, de los días de la semana pero también de otras cadenas dependientes de la localización, respetarán la localización actual definida por la función `setlocale`. La función devuelve `false` si `format` está vacío, contiene especificadores de conversión no soportados, o si la longitud de la cadena devuelta sería mayor que `4095`.

## 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`

Dado que la salida depende de la biblioteca C subyacente, algunos especificadores de conversión no son soportados. Bajo Windows, el hecho de proporcionar un especificador de conversión desconocido devolverá 5 mensajes de nivel `E_WARNING` y devolverá `false` al final. Bajo otros sistemas operativos, no recibirá ningún mensaje de nivel `E_WARNING` y la salida contendrá los especificadores no convertidos.

## Historial de cambios

| Versión | Descripción                    |
|---------|--------------------------------|
| 8.0.0   | `timestamp` ahora es nullable. |

## Ejemplos

Este ejemplo solo funcionará si tiene las localizaciones respectivas instaladas en su sistema.

Ejemplo con `strftime`