Fonction date() de PHP

❮ Référence PHP Date/Heure

Exemple

Formate une date et une heure locales et renvoie les chaînes de caractères de date formatées :

<?php
// Affiche le jour
echo date("l") . "<br>";

// Affiche le jour, la date, le mois, l'année, l'heure, AM ou PM
echo date("l jS \of F Y h:i:s A");
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction date() formate une date et une heure locales, et renvoie la chaîne de caractères de date formatée.


Syntaxe

date( format, timestamp)

Valeurs des Paramètres

Paramètre Description
format Requis. Spécifie le format de la chaîne de date renvoyée. Les caractères suivants peuvent être utilisés :
  • d - Le jour du mois (de 01 à 31)
  • D - Une représentation textuelle d'un jour (trois lettres)
  • j - Le jour du mois sans zéros devant (1 à 31)
  • l (minuscule 'l') - Une représentation textuelle complète d'un jour
  • N - La représentation numérique ISO-8601 d'un jour (1 pour lundi, 7 pour dimanche)
  • S - Le suffixe ordinal anglais pour le jour du mois (2 caractères st, nd, rd ou th. Fonctionne bien avec j)
  • w - Une représentation numérique du jour (0 pour dimanche, 6 pour samedi)
  • z - Le jour de l'année (de 0 à 365)
  • W - Le numéro de semaine ISO-8601 de l'année (semaines commençant le lundi)
  • F - Une représentation textuelle complète d'un mois (janvier à décembre)
  • m - Une représentation numérique d'un mois (de 01 à 12)
  • M - Une représentation textuelle courte d'un mois (trois lettres)
  • n - Une représentation numérique d'un mois, sans zéros devant (1 à 12)
  • t - Le nombre de jours dans le mois donné
  • L - Si c'est une année bissextile (1 si c'est une année bissextile, 0 sinon)
  • o - Le numéro d'année ISO-8601
  • Y - Une représentation à quatre chiffres d'une année
  • y - Une représentation à deux chiffres d'une année
  • a - am ou pm en minuscules
  • A - AM ou PM en majuscules
  • B - Temps Internet Swatch (000 à 999)
  • g - Format 12 heures d'une heure (1 à 12)
  • G - Format 24 heures d'une heure (0 à 23)
  • h - Format 12 heures d'une heure (01 à 12)
  • H - Format 24 heures d'une heure (00 à 23)
  • i - Minutes avec zéros devant (00 à 59)
  • s - Secondes, avec zéros devant (00 à 59)
  • u - Microsecondes (ajoutées dans PHP 5.2.2)
  • e - L'identifiant de fuseau horaire (Exemples : UTC, GMT, Atlantic/Azores)
  • I (i majuscule) - Si la date est en heure d'été (1 si c'est l'heure d'été, 0 sinon)
  • O - Différence par rapport à l'heure de Greenwich (GMT) en heures (Exemple : +0100)
  • P - Différence par rapport à l'heure de Greenwich (GMT) en heures:minutes (ajoutée dans PHP 5.1.3)
  • T - Abréviations de fuseau horaire (Exemples : EST, MDT)
  • Z - Décalage de fuseau horaire en secondes. Le décalage pour les fuseaux horaires à l'ouest de l'UTC est négatif (-43200 à 50400)
  • c - La date ISO-8601 (par exemple 2013-05-05T16:34:42+00:00)
  • r - La date formatée RFC 2822 (par exemple Ven, 12 Avr 2013 12:01:05 +0200)
  • U - Les secondes depuis l'Époque Unix (1er janvier 1970 00:00:00 GMT)

et les constantes prédéfinies suivantes peuvent également être utilisées (disponibles depuis PHP 5.1.0) :

  • DATE_ATOM - Atom (exemple : 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - Cookies HTTP (exemple : Vendredi, 12-Avr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (exemple : 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (exemple : Ven, 12 Avr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (exemple : Vendredi, 12-Avr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (exemple : Ven, 12 Avr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (exemple : Ven, 12 Avr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Ven, 12 Avr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Identique à DATE_ATOM (depuis PHP 5.1.3)
  • DATE_RSS - RSS (Ven, 12 Août 2013 15:52:01 +0000)
  • DATE_W3C - World Wide Web Consortium (exemple : 2013-04-12T15:52:01+00:00)
timestamp Optionnel. Spécifie un timestamp Unix entier. Par défaut, c'est l'heure locale actuelle (time())


Détails Techniques

Valeur de Retour : Renvoie une chaîne de caractères de date formatée en cas de succès. FALSE en cas d'échec + un E_WARNING
Version PHP : 4+
Journal des Modifications : PHP 8.0 : timestamp est nullable maintenant

❮ Référence PHP Date/Heure