Utilisation et exemples de la fonction date_create_immutable() PHP

Manuel des fonctions Date & Time PHP

La fonction date_create_immutable() retourne un nouvel objet DateTimeImmutable.

Définition et utilisation

date_create_immutable() est un alias de DateTimeImmutable::__construct(). Cette fonction accepte la date/Chaîne de temps et fuseau horaire en tant que paramètres (optionnels) et crée un objet DateTimeImmutable.
Contrairement à l'objet DateTime, cet objet ne permet aucune modification. Il crée un nouveau objet s'il y a des modifications et le renvoie. Par défaut, cette fonction crée la date actuelle./Objet de temps

Syntaxe

date_create_immutable([$date_time, $timezone]);

Paramètre

Retourne

La fonction PHP date_create_immutable() retourne l'objet DateTimeImmutable créé.

Version PHP

Cette fonction a été introduite dans la version PHP5.5introduit dans la version .0 et peut être utilisé dans toutes les versions plus élevées.

Exemple en ligne

Les exemples suivants montrentdate_create_immutable()Utilisation de la fonction-

<?php
　　　$date_string = "2019-08-15　9:25:45";
　　　$immutable = date_create_immutable($date_string);　　　
　　　print_r($immutable);
?>

Résultat de la sortie :

DateTimeImmutable Object
(
　　　　[date] =>　2019-08-15　09:25:45.000000
　　　　[timezone_type] =>　3
　　　　[timezone] => UTC
)

Exemple en ligne

Voici un exemple avec le paramètre timezone :date_create_immutable()d'exemple-

<?php
　　　$date_string = "2019-08-15　9:25:45";
　　　$tz = new DateTimeZone('Indian/Mahe');
　　　$immutable = date_create_immutable($date_string,　$tz);　　　
　　　print_r($immutable);　　　
　　　print(　date_format($immutable,'Y-m-d H:i:s'));　
?>

Résultat de la sortie :

DateTimeImmutable Object
(
　　　　[date] =>　2019-08-15　09:25:45.000000
　　　　[timezone_type] =>　3
　　　　[timezone] => Indian/Mahe
)
2019-08-15　09:25:45

Exemple en ligne

Dans l'exemple suivant, nous avons créé une date immutable et avons ajouté une intervalle à l'objet date normale, puis affiché la valeur de résultat. Comme l'objet DateTimeImmutable immutable crée et renvoie un nouveau objet lors de toute modification, vous pouvez observer qu'il change avant et après la modification-

<?php
　　　print("Date immutable : "."\n");
　　　$date1　=　date_create_immutable('1986-09-11');
　　　$date2　=　$date1->add(new　DateInterval('P15DP12MP9YT24H'));
　　　print("Valeur de l'objet original : ".$date1->format('Y-m-d')."\n");
　　　print("Modifié après : ".$date2->format('Y-m-d')."\n");
　　　print("Date normale : "."\n");
　　　$date3　=　date_create('1986-09-11');
　　　$date4　=　$date3->add(new　DateInterval('P15DP12MP9YT24H'));
　　　print("Valeur de l'objet original : ".$date3->format('Y-m-d')."\n");
　　　print("Modifié après : ".$date4->format('Y-m-d')."\n");
?>

Résultat de la sortie :

Date immutable :　
Valeur de l'objet original :　1986-09-11
Modifié après :　1996-09-27
Date normale :　
Valeur de l'objet original :　1996-09-27
Modifié après :　1996-09-27