Tutoriel : Fonction date

Tutoriel : Fonction date_modify() en PHP

PHP Version: 5.2+
Évolution de PHP: PHP 5.3 : Changement de la valeur de retour de NULL à DateTime

Définition

La fonction date_modify() en PHP est utilisée pour modifier une date en ajoutant ou en soustrayant une durée spécifiée. Elle permet de manipuler facilement les dates dans différents formats.

Syntaxe générale

La syntaxe générale de la fonction date_modify() est :

	date_modify($date, $modifier)

où :

$date : Obligatoire. La date à modifier.
$modifier : Obligatoire. La durée à ajouter ou à soustraire à la date. Elle doit être spécifiée au format interval.

Paramètres

Les paramètres de la fonction date_modify() sont les suivants :

$date : La date à modifier. Elle peut être une chaîne de caractères représentant une date dans un format valide ou un objet DateTime représentant la date.
$modifier : La durée à ajouter ou à soustraire à la date. Elle doit être spécifiée au format interval, qui peut être une chaîne de caractères dans le format ±P n D, où ± indique si l'intervalle est ajouté ou soustrait, et P...D spécifie la durée en jours, mois, années, heures, minutes et/ou secondes et n un entier qui spécifie la quantité de jours, mois, années, heures, minutes et/ou secondes à ajouter ou à soustraire.

Valeurs possibles

Les valeurs possibles pour le paramètre $modifier sont :

±PnD : Ajoute ou soustrait n jours à la date.
±PnM : Ajoute ou soustrait n mois à la date.
±PnY : Ajoute ou soustrait n années à la date.
±PTnH : Ajoute ou soustrait n heures à la date.
±PTnM : Ajoute ou soustrait n minutes à la date.
±PTnS : Ajoute ou soustrait n secondes à la date.

Exemples pratiques d'utilisation

Voici quelques exemples pratiques d'utilisation de la fonction date_modify() :

Exemple : 📋 Copier le code

<?php
// Exemple 1 ajouter 1 jour
	$date = new DateTime('2010-07-18');
	date_modify($date, '+1 day');
	echo $date->format('Y-m-d'); // Affiche '2010-07-19'
	echo "<br>";
	// Exemple 2 soustraire 1 semmaine
	$date = new DateTime('2010-07-18');
	date_modify($date, '-1 week');
	echo $date->format('Y-m-d'); // Affiche '2010-07-11'
	echo "<br>";
	// Exemple 3 ajouter 2 mois
	$date = new DateTime('2010-07-18');
	date_modify($date, '+2 months');
	echo $date->format('Y-m-d'); // Affiche '2010-09-18'
	// Exemple 4 ajouter 1 heure
	$date = new DateTime('2010-07-18 12:24:35');
	$new_date = date_modify($date, '+1 hour');
	echo $new_date->format('Y-m-d H:i:s'); // Affiche 2010-07-18 13:24:35
?>

Astuces et conseils d'utilisation

La fonction date_modify() modifie la date d'origine, donc gardez cela à l'esprit lorsque vous l'utilisez.
La fonction date_modify() peut être utilisée pour modifier n'importe quelle date ou heure.
Assurez-vous de passer une date valide à la fonction date_modify(). Si la date est invalide, une exception sera levée.
Utilisez le formatage approprié pour afficher la date modifiée à l'aide de la méthode format().
La fonction date_modify() peut être utilisée pour effectuer des calculs sur des dates et des heures.
Veillez à comprendre et à utiliser correctement le format d'intervalle pour spécifier la durée à ajouter ou à soustraire.
La fonction date_modify() peut être utilisée pour modifier le format d'une date ou d'une heure.

Reference de date/heure de PHP

Comment modifier une date ou une heure en PHP ?

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