DateTime::modify
date_modify
(PHP 5 >= 5.2.0)
DateTime::modify -- date_modify — Modifie le timestamp
Description
Style orienté objet
Style procédural
Modifie le timestamp d'un objet DateTime en l'incrémentant ou le décrémentant dans un format acceptable par strtotime().
Liste de paramètres
-
object
-
Style procédural uniquement : Un objet DateTime retourné par la fonction date_create(). Cette fonction modifie cet objet.
-
modify
-
Une chaîne date/heure. Les formats valides sont expliqués dans la documentation sur les formats Date et Heure.
Valeurs de retour
Retourne l'objet DateTime pour chainer les méthodes ou FALSE
si une erreur survient.
Historique
Version | Description |
---|---|
5.3.6 | Les requêtes date/heure absolues prennent maintenant effets. Auparavant, seules les parties relatives étaient utilisées. |
5.3.0 | Changement de
valeur de retour de NULL à DateTime en cas de succès. |
Exemples
Exemple #1 Exemple avec DateTime::modify()
<?php $date = new DateTime('2006-12-12'); $date->modify('+1 day'); echo $date->format('Y-m-d'); ?>
<?php $date = date_create('2006-12-12'); date_modify($date, '+1 day'); echo date_format($date, 'Y-m-d'); ?>
<?php $date = new DateTime('2000-12-31'); $date->modify('+1 month'); echo $date->format('Y-m-d') . "\n"; $date->modify('+1 month'); echo $date->format('Y-m-d') . "\n"; ?>
L'exemple ci-dessus va afficher :
2001-01-31 2001-03-03
Voir aussi
- strtotime() - Transforme un texte anglais en timestamp
- DateTime::add() - Ajoute une durée à un objet DateTime
- DateTime::sub() - Soustrait une durée à un objet DateTime
- DateTime::setDate() - Assigne la date
- DateTime::setISODate() - Configure une date ISO
- DateTime::setTime() - Assigne l'heure
- DateTime::setTimestamp() - Assigne la date et l'heure à l'aide d'un timestamp Unix