DateTime
PHP Manual

DateTime::sub

(PHP 5 >= 5.3.0)

DateTime::sub Soustrait une durée à un objet DateTime

Description

public DateTime DateTime::sub ( DateInterval $interval )
DateTime date_sub ( DateTime $object , DateInterval $interval )

Soustrait la durée spécifiée par l'objet DateInterval de l'objet DateTime.

Liste de paramètres

object

Seulement en style procédural : un objet DateTime retourné par date_create()

interval

La durée à soustraire. 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_sub()

<?php

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

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

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

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

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

date_sub($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
PHP Manual