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)