Formater les intervalles de temps avec date_interval_format() en PHP : Tutoriel détaillé

Tutoriel PHP : Fonction date_interval_format()

  PHP Version:	5.3+
Évolution de PHP:	PHP 7.1 : Ajout des paramètres F et f
  

Définition

La fonction date_interval_format() est une fonction intégrée de PHP qui permet de formater un intervalle de temps spécifié en utilisant un objet DateInterval selon un format spécifié.

Syntaxe générale

string date_interval_format ( DateInterval $interval , string $format )

Paramètres

• $interval: L'objet DateInterval à formater.
• $format: Le format de sortie souhaité. Il peut contenir des spécificateurs de formatage similaires à la fonction date().

Valeurs possibles

La fonction date_interval_format() accepte les spécificateurs de formatage suivants :

Les caractères suivants peuvent être utilisés dans la chaîne du paramètre $format :

• % - % littéral
• Y - Année, au moins 2 chiffres avec un zéro en tête (par exemple 03)
• y - Année (par exemple 3)
• M - Mois, avec un zéro en tête (par exemple 06)
• m - Mois (par exemple 6)
• D - Jour, avec zéro en tête (ex. 09)
• d - Jour (par exemple 9)
• a - Nombre total de jours résultant de la fonction date_diff()
• H - Heures, avec zéro en tête (par exemple 08, 23)
• h - Heures (par exemple 8, 23)
• I - Minutes, avec zéro en tête (par exemple 08, 23)
• i - Minutes (par exemple 8, 23)
• S - Secondes, avec zéro en tête (par ex. 08, 23)
• s - Secondes (par exemple 8, 23)
• F - Microsecondes, au moins 6 chiffres (par exemple 004403, 235689)
• f - Microsecondes (par exemple 4403, 235689)
• R - Signe "-" si négatif, "+" si positif
• r - Signe "-" lorsqu'il est négatif, vide lorsqu'il est positif

Remarque : chaque caractère de format doit être précédé du signe % !

Exemples pratiques d'utilisation

Voici quelques exemples pour illustrer l'utilisation de la fonction date_interval_format():

Exemple :     📋 Copier le code

  <?php
$interval = new DateInterval('P2Y5M10DT2H30M45S');
echo date_interval_format($interval, '%Y years, %m months, %d days, %H hours, %i minutes, %s seconds');
// Output: 2 years, 5 months, 10 days, 2 hours, 30 minutes, 45 seconds

$interval = new DateInterval('P1M15D');
echo date_interval_format($interval, '%m months and %d days');
// Output: 1 month and 15 days
?>

Astuces et conseils d'utilisation

• Assurez-vous d'utiliser un objet DateInterval valide comme premier argument.
• Veillez à utiliser les spécificateurs de formatage appropriés dans le format de sortie.
• Expérimentez avec différents formats pour obtenir le résultat souhaité.
• Consultez la documentation officielle de PHP pour plus d'informations sur les spécificateurs de formatage disponibles.

Reference de date/heure de PHP