Función PHP date_create_immutable_from_format ()

Definición y uso

Thie date_create_immutable_from_format () funciona un alias de DateTimeImmutable :: createFromFormat () . Acepta una cadena de tiempo y una cadena de formato como parámetros, analiza la cadena de tiempo dada en el formato especificado y devuelve un objeto DateTimeImmutable.

Sintaxis

date_create_immutable_from_format($date, $time [,$timezone])

Parámetros

No Señor	Descripción de parámetros
1	format(Mandatory) Este es un valor de cadena que representa el formato en el que necesita analizar la cadena de tiempo dada.
2	time(Mandatory) Este es un valor de cadena que representa el tiempo que necesita para analizar.
3	timezone(Optional) Este es un objeto de la clase DateTimeZone que representa la zona horaria deseada.

Valores devueltos

La función PHP date_create_immutable_from_format () devuelve un objeto DateTime que representa la hora analizada. En caso de falla, esta función devuelve el valor booleano falso .

Versión PHP

Esta función se introdujo por primera vez en PHP Versión 5.5.0 y funciona con todas las versiones posteriores.

Ejemplo

El siguiente ejemplo demuestra el uso de la función date_create_immutable_from_format () -

<?php
   //Creating a DateTime object
   $date = "25-Mar-1989";
   $format = "d-M-Y";
   $res = date_create_immutable_from_format($format, $date);
   print("Date: ".date_format($res, "Y-m-d"));
?>

Esto producirá el siguiente resultado:

Date: 1989-03-25

Ejemplo

Ahora, intentemos pasar el parámetro de zona horaria opcional:

<?php
   //Creating a DateTime object
   $date = "25-Mar-1989";
   $format = "d-M-Y";
   $tz = new DateTimeZone('Indian/Mahe');  
   $res = date_create_immutable_from_format($format, $date, $tz);
   print date_format($res, "Y-m-d");
?>

Esto producirá el siguiente resultado:

1989-03-25

Ejemplo

El siguiente ejemplo demuestra date_create_immutable_from_format () con diferentes formatos:

<?php
   $res1 = date_create_immutable_from_format("j.n.Y", "25.8.2014");
   print(date_format($res1, "Y-m-d"));
   print("\n");
   $res2 = date_create_immutable_from_format('Y-d-m H:i:s', '2014-25-08 12:20:25');
   print(date_format($res2, "Y-m-d H:i:s"));  
?>

Esto producirá el siguiente resultado:

2014-08-25
2014-08-25 12:20:25

↰ Previous page