logo oujood
🔍

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

OUJOOD.COM

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