DateTimeInterface
DateTime::format
DateTimeInterface
PHP Manual

# DateTime::diff

# DateTimeImmutable::diff

# DateTimeInterface::diff

# date_diff

(PHP 5 >= 5.3.0)

DateTime::diff -- DateTimeImmutable::diff -- DateTimeInterface::diff -- date_diff — Retourne la différence entre deux objets DateTime

### Description

Style orienté objet

public DateInterval DateTime::diff ( DateTimeInterface `$datetime2` [, bool `$absolute` = false ] )
public DateInterval DateTimeImmutable::diff ( DateTimeInterface `$datetime2` [, bool `$absolute` = false ] )
public DateInterval DateTimeInterface::diff ( DateTimeInterface `$datetime2` [, bool `$absolute` = false ] )

Style procédural

DateInterval date_diff ( DateTimeInterface `$datetime1` , DateTimeInterface `$datetime2` [, bool `$absolute` = false ] )

Retourne la différence entre deux objets DateTimeInterface.

### Liste de paramètres

`datetime`

  La date à comparer.

`absolute`

  Doit-on forcer l'intervalle à être positif ?

### Valeurs de retour

L'objet DateInterval représentant la différence entre les deux dates ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Exemple avec DateTime::diff()

Style orienté objet

`<?php
$datetime1 = new DateTime('2009-10-11');
$datetime2 = new DateTime('2009-10-13');
$interval = $datetime1->diff($datetime2);
echo $interval->format('%R%a days');
?>`

Style procédural

`<?php
$datetime1 = date_create('2009-10-11');
$datetime2 = date_create('2009-10-13');
$interval = date_diff($datetime1, $datetime2);
echo $interval->format('%R%a days');
?>`

Les exemples ci-dessus vont afficher :

    +2 days

Exemple #2 Comparaison de deux objets DateTime

> Note:

> Depuis PHP 5.2.2, les objets DateTime peuvent être comparés en utilisant les opérateurs de comparaison.

`<?php
$date1 = new DateTime("now");
$date2 = new DateTime("tomorrow");
var_dump($date1 == $date2);
var_dump($date1 < $date2);
var_dump($date1 > $date2);
?>`

L'exemple ci-dessus va afficher :

    bool(false)
    bool(true)
    bool(false)

### Voir aussi

- DateInterval::format() - Formate l'intervalle
- DateTime::add() - Ajoute une durée à un objet DateTime
- DateTime::sub() - Soustrait une durée à un objet DateTime

DateTimeInterface
DateTime::format
DateTimeInterface
PHP Manual