DateTimeInterface::formatDateTimeImmutable::formatDateTime::formatdate_formatRetorna una fecha formateada según el formato proporcionado
&reftitle.description;
&style.oop;publicstringDateTimeInterface::formatstringformatpublicstringDateTimeImmutable::formatstringformatpublicstringDateTime::formatstringformat&style.procedural;stringdate_formatDateTimeInterfaceobjectstringformat
Retorna una fecha formateada según el formato proporcionado.
&reftitle.parameters;
&date.datetime.description;
format
El formato de la fecha deseada. Ver las opciones de formato a continuación.
Existen también numerosas
constantes de fechas
que pueden ser utilizadas, lo que hace que DATE_RSS
reemplace el formato "D, d M Y H:i:s".
Los siguientes caracteres son reconocidos en el parámetro
formatCaracteres para el parámetro formatDescripciónEjemplos de valores retornadosDía------dDía del mes, en dos dígitos (con un cero inicial)01 a 31DDía de la semana, en tres letras (y en inglés - por defecto: en inglés, o sino, en el idioma local del servidor)Mon a SunjDía del mes sin los ceros iniciales1 a 31l ('L' minúscula)Día de la semana, textual, versión larga, en inglésSunday a SaturdayNRepresentación numérica ISO 8601 del día de la semana1 (para Lunes) a 7 (para Domingo)SSufijo ordinal de un número para el día del mes, en inglés, en dos letrasst, nd, rd o
th. Funciona bien con jwDía de la semana en formato numérico0 (para domingo) a 6 (para sábado)zDía del año0 a 365Semana------WNúmero de semana en el año ISO 8601, las semanas comienzan
el lunesEjemplo: 42 (la 42ª semana del año)Mes------FMes, textual, versión larga; en inglés, como
January o DecemberJanuary a DecembermMes en formato numérico, con ceros iniciales01 a 12MMes, en tres letras, en inglésJan a DecnMes sin los ceros iniciales1 a 12tNúmero de días en el mes28 a 31Año------L¿Es el año bisiesto?1 si es bisiesto, 0 si no.oAño de numeración de semanas ISO 8601. Es el mismo valor que
Y, excepto si el número de semana ISO
(W) pertenece al año anterior o siguiente,
este año será utilizado en su lugar.Ejemplos: 1999 o 2003X
Una representación numérica completa extendida de un año, de al menos 4 dígitos,
con un - para los años antes de la era común
y un + para los años de la era común.
Ejemplos: -0055, +0787,
+1999, +10191x
Una representación numérica completa extendida si es necesario,
o una representación numérica completa estándar si es posible (como Y).
Al menos cuatro dígitos. Los años anteriores a la era común son prefijados por un -.
Los años más allá (y incluyendo) del 10000 son prefijados por un +.
Ejemplos: -0055, 0787,
1999, +10191YUna representación numérica completa de un año, al menos 4 dígitos, con - para los años av. J.-C.Ejemplos: -0055, 0787,
1999, 2003, 10191yAño en 2 dígitosEjemplos: 99 o 03Hora------aAnte meridiem y Post meridiem en minúsculasam o pmAAnte meridiem y Post meridiem en mayúsculasAM o PMBHora Internet Swatch000 a 999gHora, en formato 12h, sin los ceros iniciales1 a 12GHora, en formato 24h, sin los ceros iniciales0 a 23hHora, en formato 12h, con los ceros iniciales01 a 12HHora, en formato 24h, con los ceros iniciales00 a 23iMinutos con ceros iniciales00 a 59sSegundos con ceros iniciales00 a 59u
Microsegundos. Tenga en cuenta que la función
date generará siempre
000000 ya que toma un parámetro de tipo
entero, mientras que el método DateTimeInterface::format
soporta microsegundos si un objeto de tipo
DateTimeInterface fue creado con microsegundos.
Ejemplo: 654321v
Milisegundos. Misma nota que para
u.
Ejemplo: 654Zona horaria------eEl identificador de la zona horariaEjemplos: UTC, GMT, Atlantic/AzoresI (i mayúscula)La hora de verano está activada o no1 si sí, 0 si no.ODiferencia de horas con la hora de Greenwich (GMT), sin
dos puntos entre las horas y los minutosEjemplo: +0200PDiferencia con la hora Greenwich (GMT) con un dos puntos
entre las horas y los minutosEjemplo: +02:00p
Idéntico a P, pero retorna Z en lugar de +00:00
(disponible a partir de PHP 8.0.0)
Ejemplos: Z o +02:00TAbreviación de la zona horaria, si es conocida; sino, desplazamiento desde GMTEjemplos: EST, MDT, +05ZDesplazamiento horario en segundos. El desplazamiento de zonas al oeste
de la zona UTC es negativo, y al este, es positivo.-43200 a 50400Fecha y Hora completa------cFecha en formato ISO 8601. Solo compatible con el formato no expandido (hasta el año 9999). Las fechas posteriores generarán una cadena no válida. Para fechas posteriores y el formato expandido, consulte x y X.2004-02-12T15:19:21+00:00rFormato de fecha RFC 2822/RFC 5322Ejemplo: Thu, 21 Dec 2000 16:01:070200USegundos desde la época Unix (1 de Enero de 1970, 0h00 00s GMT)Ver también time
Los caracteres no reconocidos serán impresos tal cual.
"Z" retornará siempre 0 cuando se utiliza con
gmdate.
Sabiendo que esta función solo acepta enteros en forma de timestamp,
el carácter u solo es útil al utilizar la función
date_format con un timestamp de usuario creado con la función
date_create.
&reftitle.returnvalues;
Retorna la fecha formateada, en forma de string,
en caso de éxito.
&reftitle.changelog;
&Version;&Description;8.2.0
Los caracteres de formato X o x
han sido añadidos.
8.0.0
El carácter de formato p ha sido añadido.
&reftitle.examples;
Ejemplo con DateTime::format&style.oop;
format('Y-m-d H:i:s');
?>
]]>
&example.outputs;
&style.procedural;
]]>
&example.outputs;
Más ejemplos
format('l'), "\n";
// Imprime algo como: Wednesday 19th of October 2022 08:40:48 AM
echo $date->format('l jS \o\f F Y h:i:s A'), "\n";
/* use the constants in the format parameter */
// imprime algo como: Wed, 19 Oct 2022 08:40:48 +0000
echo $date->format(DateTimeInterface::RFC2822), "\n";
?>
]]>
Es posible evitar que un carácter reconocido en la cadena de formato
se expanda escapándolo con un backslash (barra invertida). Si el carácter con
backslash es ya una secuencia especial, será necesario también escapar
el backslash.
Escape de caracteres durante el formato
format('l \t\h\e jS');
?>
]]>
Para formatear fechas en otros idiomas,
IntlDateFormatter::format
puede ser utilizada en lugar de DateTimeInterface::format.
&reftitle.notes;
Este método no utiliza locales. Todos los despliegues
serán en inglés.
&reftitle.seealso;
IntlDateFormatter::format