Función PHP date_format ()
Definición y uso
Esta función es un alias de DateTime::format()función. Acepta un objeto DateTime y una cadena de formato (que representa un formato de fecha / hora deseado) como parámetros, formatea el objeto en el formato especificado y devuelve el resultado.
Sintaxis
date_format($date_time_object, $format)
Parámetros
No Señor | Descripción de parámetros |
---|---|
1 | date_time_object(Mandatory) Este es el objeto DateTime que necesita formatear. |
2 | format(Mandatory) Esta es la cadena que representa el formato deseado. |
Valores devueltos
La función PHP date_format () devuelve la cadena de fecha formateada
Versión PHP
Esta función se introdujo por primera vez en PHP versión 5.2.1 y funciona en todas las versiones posteriores.
Ejemplo
Pruebe el siguiente ejemplo aquí, estamos creando un objeto DateTime y formateándolo:
<?php
//Creating a DateTime object
$date_time_Obj = date_create("25-09-1989");
//formatting the date/time object
$format = date_format($date_time_Obj, "y-d-m");
print("Date in yy-dd-mm format: ".$format);
?>
Esto producirá el siguiente resultado:
Date in yy-dd-mm format: 89-25-09
Ejemplo
El siguiente ejemplo formatea un objeto DateTime como fecha y hora por separado:<?php
$dateString = '11-06-2012 12:50:41 GMT';
$dateTimeObj = date_create($dateString);
$date = date_format($dateTimeObj, 'd-m-y');
print("Date: ".$date);
print("\n");
$time = date_format($dateTimeObj, 'H:i:s');
print("Time: ".$time);
?>
Esto producirá el siguiente resultado:
Date: 11-06-12
Time: 12:50:41
Ejemplo
El siguiente ejemplo demuestra pocas cadenas de formato válidas en PHP:
<?php
$dateTimeObj = date_create("11-06-2012 12:50:41 GMT");
print("Date in y-m-d format: ".date_format($dateTimeObj, 'Y-m-d'));
print("\n");
print("Date in d/m/y format: ".date_format($dateTimeObj, 'd/m/y'));
print("\n");
print("Date in Y-m-d H:i:s format: ".date_format($dateTimeObj, 'Y-m-d H:i:s'));
print("\n");
print("Date in G:i:A format: ".date_format($dateTimeObj, 'G-i-A'));
?>
Esto producirá el siguiente resultado:
Date in y-m-d format: 2012-06-11
Date in d/m/y format: 11/06/12
Date in Y-m-d H:i:s format: 2012-06-11 12:50:41
Date in G:i:A format: 12-50-PM
Ejemplo
El siguiente ejemplo crea una nueva fecha usando el método date_format () -
<?php
$dateSrc = '2005-04-19 12:50 GMT';
$dateTime = date_create( $dateSrc);;
# Now set a new date using date_format();
date_format( $dateTime, 2000, 12, 12);
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
echo "
";
# Using second function.
$dateTime = new DateTime($dateSrc);
$dateTime->setDate( 1999, 10, 12);
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
?>
Esto produce la siguiente salida:
New Formatted date is 2000-12-12T12:50:00Z
New Formatted date is 1999-10-12T12:50:00Z
Cadena de formato
Hay ciertos caracteres con un significado predefinido con los que puede crear una cadena de formato. Son:
d - El día del mes (del 01 al 31)
D: una representación textual de un día (tres letras)
j - El día del mes sin ceros iniciales (1 a 31)
l ('L' minúscula): una representación textual completa de un día
N: la representación numérica ISO-8601 de un día (1 para el lunes al 7 para el domingo)
S: el sufijo ordinal en inglés para el día del mes (2 caracteres st, nd, rd o th. Funciona bien con j)
w: una representación numérica del día (0 para el domingo hasta 6 para el sábado)
z: el día del año (de 0 a 365)
W: el número de semana ISO-8601 del año (semanas a partir del lunes)
F: una representación textual completa de un mes (de enero a diciembre)
m: una representación numérica de un mes (del 01 al 12)
M: una breve representación textual de un mes (tres letras)
n: representación numérica de un mes, sin ceros a la izquierda (1 a 12)
t: el número de días del mes dado
L: si es un año bisiesto (1 si es un año bisiesto, 0 en caso contrario)
o - El número de año ISO-8601
Y: una representación de cuatro dígitos de un año
y: una representación de dos dígitos de un año
a: am minúscula o pm
A - AM o PM en mayúsculas
B - Swatch Internet time (000 a 999)
g - formato de 12 horas de una hora (1 a 12)
G - formato de 24 horas de una hora (0 a 23)
h - formato de 12 horas de una hora (01 a 12)
H - formato de 24 horas de una hora (00 a 23)
i - Minutos con ceros a la izquierda (00 a 59)
s: segundos, con ceros a la izquierda (00 a 59)
e - El identificador de zona horaria (Ejemplos: UTC, Atlántico / Azores)
I (i mayúscula): si la fecha está en el horario de verano (1 si es el horario de verano, 0 en caso contrario)
O - Diferencia con la hora de Greenwich (GMT) en horas (Ejemplo: +0100)
T - Configuración de la zona horaria de la máquina PHP (Ejemplos: EST, MDT)
Z - Desplazamiento de zona horaria en segundos. El desplazamiento al oeste de UTC es negativo y el desplazamiento al este de UTC es positivo (-43200 a 43200)
c - La fecha ISO-8601 (por ejemplo, 2004-02-12T15: 19: 21 + 00: 00)
r - La fecha con formato RFC 2822 (p. ej., jueves, 21 de diciembre de 2000 16:01:07 +0200)
U - Los segundos desde la época de Unix (1 de enero de 1970 00:00:00 GMT)