Fonction PHP date_create_immutable_from_format ()

Définition et utilisation

Thie date_create_immutable_from_format () fonctionne un alias de DateTimeImmutable :: createFromFormat () . Il accepte une chaîne d'heure et une chaîne de format comme paramètres, analyse la chaîne d'heure donnée au format spécifié et renvoie un objet DateTimeImmutable.

Syntaxe

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

Paramètres

Sr.Non	Paramètre et description
1	format(Mandatory) Il s'agit d'une valeur de chaîne représentant le format dans lequel vous devez analyser la chaîne de temps donnée.
2	time(Mandatory) Il s'agit d'une valeur de chaîne représentant le temps dont vous avez besoin pour l'analyse.
3	timezone(Optional) Il s'agit d'un objet de la classe DateTimeZone représentant le fuseau horaire souhaité.

Valeurs de retour

La fonction PHP date_create_immutable_from_format () renvoie un objet DateTime représentant l'heure analysée. En cas d'échec, cette fonction renvoie la valeur booléenne false .

Version PHP

Cette fonction a été introduite pour la première fois dans la version 5.5.0 de PHP et fonctionne avec toutes les versions ultérieures.

Exemple

L'exemple suivant montre l'utilisation de la fonction 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"));
?>

Cela produira le résultat suivant -

Date: 1989-03-25

Exemple

Maintenant, essayons de passer le paramètre optionnel de fuseau horaire -

<?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");
?>

Cela produira le résultat suivant -

1989-03-25

Exemple

L'exemple suivant montre date_create_immutable_from_format () avec différents formats -

<?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"));  
?>

Cela produira la sortie suivante -

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