DateTime::add

(PHP 5 >= 5.3.0)

DateTime::add — Ajoute une durée à un objet DateTime

Description

public DateTime DateTime::add ( string $interval )

DateTime date_add ( DateTime $object , DateInterval $interval )

Ajoute la durée de l'objet DateInterval à l'objet DateTime.

Liste de paramètres

object: Seulement en style procédural : un objet DateTime retourné par date_create()
interval: La durée à ajouter. Pour les dates, utilisez "P3D", "P3M", "P3Y" ou une combinaison des droits, e.g. "P2M5D" (Y = Années, M = Mois, D = Jours.) Important : le format doit être année, mois et jour, "P5Y", "P5M2D", "P5Y4D". Pour l'heure, utilisez "T3H", "T3M", "T3S" ou une combinaison des trois, e.g. "T5H20M" (H = Heures, M = Minutes, S = Secondes). Pour une date et heure, utilisez "P5D2M4YT5H20M". Les chiffres avant les lettres peuvent être n'importe quelle valeur.

Valeurs de retour

Retourne l'objet DateTime modifié.

Exemples

Exemple #1 Exemple avec date_add()


<?php

$date = new DateTime("18-July-2008 16:30:30");
echo $date->format("d-m-Y H:i:s").'<br />';

date_add($date, new DateInterval("P5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days';

date_add($date, new DateInterval("P5M"));
echo '<br />'.$date->format("d-m-Y").' : 5 Months';

date_add($date, new DateInterval("P5Y"));
echo '<br />'.$date->format("d-m-Y").' : 5 Years';

date_add($date, new DateInterval("P5Y5M5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days, 5 Months, 5 Years';

date_add($date, new DateInterval("P5YT5H"));
echo '<br />'.$date->format("d-m-Y H:i:s").' : 5 Years, 5 Hours';

?>

Notes

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Voir aussi

DateTime::sub() - Soustrait une durée à un objet DateTime
DateTime::diff() - Retourne la différence entre deux objets DateTime

add a note User Contributed Notes
DateTime::add

antonchanning at gmail dot com
23-Sep-2009 12:32


If you are currently using php 5.2.x (The latest version in the Ubuntu repository is 5.2.4 as I write this), and need to add to a date, consider whether using DateTime::modify will work for you, as DateTime::add is only available from 5.3

add a note

DateTime::__construct

DateTime

Last updated: Fri, 14 Aug 2009