(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::modify — Créée un nouvel objet avec l'horodatage modifié
Crée un nouvel objet DateTimeImmutable avec l'horodatage modifié. L'objet original ne sera pas modifié.
modifierUne chaîne date/heure. Les formats valides sont expliqués dans la documentation sur les formats Date et Heure.
Retourne DateTimeImmutable en cas de succès.
Style procédural retourne false en cas d'erreur.
Si une chaîne de date ou de temps invalide est fournie, une DateMalformedStringException est lancé. Antérieur à PHP 8.3, ceci était un avertissement.
| Version | Description |
|---|---|
| 8.3.0 |
DateTimeImmutable::modify() lance désormais
DateMalformedStringException si une
chaîne invalide est fourni. Auparavant, il retournait false,
et un avertissement était émis.
|
Exemple #1 Exemple de DateTimeImmutable::modify()
Style orienté objet
<?php
$date = new DateTimeImmutable('2006-12-12');
$newDate = $date->modify('+1 day');
echo $newDate->format('Y-m-d');
?>Les exemples ci-dessus vont afficher :
2006-12-13
Exemple #2 Faire attention lors de l'ajout ou soustraction de mois
<?php
$date = new DateTimeImmutable('2000-12-31');
$newDate1 = $date->modify('+1 month');
echo $newDate1->format('Y-m-d') . "\n";
$newDate2 = $newDate1->modify('+1 month');
echo $newDate2->format('Y-m-d') . "\n";
?>L'exemple ci-dessus va afficher :
2001-01-31 2001-03-03