Tutoriel : La fonction date

Tutoriel : La fonction date_diff() en PHP

PHP Version: 5.3+

Définition

La fonction date_diff() est une fonction intégrée du langage PHP qui permet de calculer la différence entre deux objets DateTime. Elle renvoie un objet DateInterval contenant la différence entre les deux dates spécifiées.

Syntaxe générale

date_diff($date1, $date2, $absolute)

Paramètres

$date1 : L'objet DateTime de la première date.
$date2 : L'objet DateTime de la deuxième date.
$absolute (facultatif) : Un booléen indiquant si la différence doit être retournée en valeur absolue (par défaut false).

Valeurs possibles

La fonction date_diff() renvoie un objet DateInterval qui contient les informations suivantes :

y : Le nombre d'années de différence.
m : Le nombre de mois de différence.
d : Le nombre de jours de différence.
h : Le nombre d'heures de différence.
i : Le nombre de minutes de différence.
s : Le nombre de secondes de différence.

Exemples pratiques d'utilisation

Exemple : Copier le code

<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title>Exemple La fonction date_diff() en PHP</title>
</head>
<body>
<?php
$date1 = new DateTime('2021-01-01');
$date2 = new DateTime('2023-07-10');
$diff = date_diff($date1, $date2);

echo "La différence entre ces deux dates est: ".$diff->format('%y années, %m mois, %d jours');
// Résultat : 2 années, 6 mois, 9 jours
?>
</body>
</html>

Astuces et conseils d'utilisation

Assurez-vous d'avoir inclus la classe DateTime avant d'utiliser la fonction date_diff().
La fonction date_diff() fonctionne avec des objets DateTime, vous devez donc créer ces objets à partir des dates que vous souhaitez comparer.
Utilisez la méthode format() de l'objet DateInterval pour afficher la différence de dates de la manière souhaitée.
Si vous souhaitez obtenir la différence en valeur absolue, passez true en tant que troisième argument de la fonction date_diff().

Plus d'exemples

Exemples supplémentaires d'utilisation :

Exemple : Copier le code

$date1 = new DateTime('2022-03-15');
$date2 = new DateTime('2023-07-10');
$diff = date_diff($date1, $date2);

echo $diff->format('%y années, %m mois, %d jours');
// Résultat : 1 année, 3 mois, 26 jours

// Exemple avec la valeur absolue
$date3 = new DateTime('2023-09-30');
$date4 = new DateTime('2023-10-01');
$diff2 = date_diff($date3, $date4, true);

echo $diff2->format('%d jours');
// Résultat : 1 jour

N'hésitez pas à expérimenter avec différents formats de sortie en utilisant la méthode format() de l'objet DateInterval.

Reference de date/heure de PHP

La fonction date_diff() en PHP : Comparaison et manipulation de dates

Références des fonctions de date/heure de PHP