DateTime::setTimezone
DateTime::__wakeup
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::add() - Ajoute une durée à un objet DateTime
- DateTime::diff() - Retourne la différence entre deux objets DateTime

DateTime::setTimezone
DateTime::__wakeup
DateTime
PHP Manual