Aller au contenu

date()

Introduction

La fonction date() est l'une des fonctions intégrées les plus couramment utilisées dans PHP pour formater les dates et les heures. Ce guide couvre ses paramètres, des exemples d'utilisation et comment résoudre les problèmes courants.

Vue d'ensemble de la fonction date() de PHP

La fonction date() est une fonction intégrée de PHP qui permet de formater la date et l'heure de différentes manières. Elle prend deux paramètres : la chaîne de format et l'horodatage. La chaîne de format spécifie comment la date et l'heure doivent être formatées, tandis que l'horodatage est optionnel et indique l'horodatage à formater. Si l'horodatage n'est pas spécifié, la date et l'heure actuelles sont utilisées.

Paramètres de la fonction date()

La chaîne de format utilisée dans la fonction date() peut contenir divers caractères de format qui sont remplacés par les valeurs correspondantes pour formater la date et l'heure. Parmi les caractères de format les plus couramment utilisés, on trouve :

  • d: Jour du mois (01 à 31)
  • m: Mois (01 à 12)
  • Y: Année (sur quatre chiffres)
  • H: Heure au format 24 heures (00 à 23)
  • i: Minutes (00 à 59)
  • s: Secondes (00 à 59)
  • l: Représentation textuelle complète du jour de la semaine (dimanche–samedi)

Remarque : Les caractères de format sont sensibles à la casse. Par exemple, d affiche le jour avec des zéros non significatifs (01–31), tandis que D affiche le jour sous forme d'abréviation textuelle (lun.–dim.). De même, l (L minuscule) donne le nom complet du jour, alors que L indique si l'année est bissextile (1 ou 0).

Exemples d'utilisation

Examinons quelques exemples d'utilisation de la fonction date() pour formater la date et l'heure :

php
echo date("Y/m/d"); // outputs: 2023/03/02
php
echo date("H:i:s"); // outputs: 14:35:22
php
echo date("Y-m-d H:i:s"); // outputs: 2023-03-02 14:35:22

Vous pouvez également passer un horodatage optionnel en tant que deuxième paramètre pour formater un moment précis :

php
echo date("Y-m-d", 1677724800); // outputs: 2023-03-02 (UTC)

Remarque : L'horodatage 1677724800 représente un moment précis en UTC. La date affichée changera si le fuseau horaire par défaut de votre serveur diffère de l'UTC.

Comme vous pouvez le voir, la chaîne de format peut être personnalisée pour afficher la date et l'heure dans différents formats.

Résolution des problèmes courants

Les développeurs peuvent rencontrer quelques problèmes courants lors de l'utilisation de la fonction date(). Voici les problèmes les plus fréquents et leurs solutions :

  • Caractères de format non reconnus : date() affiche littéralement tout caractère de format non reconnu au lieu de générer une erreur. Assurez-vous d'utiliser des caractères de format valides issus de la documentation officielle de PHP.
  • Limites de plage d'horodatage : Sur les systèmes 32 bits, les horodatages en dehors de la plage 1970–2038 peuvent entraîner des résultats inattendus ou un dépassement d'entier. Utilisez la classe DateTime pour les dates en dehors de cette plage.
  • Avertissements de fuseau horaire : À partir de PHP 8.1, l'appel de date() sans fuseau horaire configuré déclenche un avertissement de dépréciation. Définissez le fuseau horaire au début de votre script à l'aide de date_default_timezone_set('UTC'); (ou de votre fuseau horaire préféré).

Conclusion

En conclusion, la fonction date() de PHP est un outil puissant qui permet aux développeurs de formater la date et l'heure de différentes manières. Avec ses paramètres personnalisables et sa facilité d'utilisation, elle est un choix populaire parmi les développeurs du monde entier. Pour des opérations de date et d'heure plus complexes, envisagez d'utiliser la classe moderne DateTime de PHP, qui offre des méthodes orientées objet et une meilleure gestion des fuseaux horaires. En suivant les directives présentées dans cet article, vous pourrez éviter les problèmes courants et tirer le meilleur parti de cette fonction polyvalente.

Pratique

Quelles fonctions sont utilisées dans PHP pour retourner des informations sur le calendrier spécifié ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.