Fonction date() PHP

Fonctions Date / Time PHP

Exemple

Formater la date et l'heure locale, et retourner une chaîne de caractères de date formatée :

<?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");
?>

Exemple de fonctionnement

Définition et utilisation

La fonction date() formate la date et l'heure locale, et retourne une chaîne de caractères de date formatée.

Syntaxe

date(format,timestamp);
Paramètres Description
format

Requis. Définit le format de la chaîne de date de sortie. Vous pouvez utiliser les caractères suivants :

  • d - Le jour du mois (de 01 à 31)
  • D - Le texte du jour de la semaine (représenté par trois lettres)
  • j - Le jour du mois sans zéro initial (1 à 31)
  • l (la forme minuscule de L) - Le texte complet du jour de la semaine
  • N - Le chiffre du jour de la semaine selon le format ISO-8601 (1 pour lundi, 7 pour dimanche)
  • S - Le suffixe ordinal du jour du mois en anglais (2 caractères : st, nd, rd ou th. Utilisé avec j)
  • w - Le chiffre du jour de la semaine (0 pour dimanche, 6 pour samedi)
  • z - Le jour de l'année (de 0 à 365)
  • W - Le numéro de la semaine de l'année selon le format ISO-8601 (le lundi commence la semaine)
  • F - Le texte complet du mois (de janvier [janvier] à décembre [décembre])
  • m - Le chiffre du mois (de 01 à 12)
  • M - Le texte abrégé du mois (représenté par trois lettres)
  • n - Le chiffre du mois sans zéro initial (1 à 12)
  • t - Le nombre de jours dans le mois donné
  • L - Si c'est une année bissextile (1 si oui, 0 sinon)
  • o - Le nombre de l'année selon le standard ISO-8601
  • Y - Les quatre chiffres pour l'année
  • y - Le deux chiffres pour l'année
  • a - La forme minuscule représente : am ou pm
  • A - Forme majuscule : AM ou PM
  • B - Swatch Internet Time (000 à 999)
  • g - Heure en 12 heures sans zéro initial (1 à 12)
  • G - Heure en 24 heures sans zéro initial (0 à 23)
  • h - Heure en 12 heures avec zéro initial (01 à 12)
  • H - Heure en 24 heures avec zéro initial (00 à 23)
  • i - Minute avec zéro initial (00 à 59)
  • s - Seconde avec zéro initial (00 à 59)
  • u - Microsecondes (ajoutées dans PHP 5.2.2)
  • e - Identifiant de fuseau horaire (par exemple : UTC, GMT, Atlantic/Azores)
  • I (en majuscule) - Si la date est dans l'heure d'été (1 si c'est le cas, 0 sinon)
  • O - Écart par rapport au GMT en heures (par exemple +0100)
  • P - Écart par rapport au GMT en heures:minutes (ajouté dans PHP 5.1.3)
  • T - Abréviation de fuseau horaire (par exemple EST, MDT)
  • Z - Décalage horaire en secondes. Le décalage pour les fuseaux horaires à l'ouest de l'UTC est négatif (-43200 à 50400)
  • c - Date au format ISO-8601 (par exemple 2013-05-05T16:34:42+00:00)
  • r - Date au format RFC 2822 (par exemple ven, 12 avr 2013 12:01:05 +0200)
  • U - Le nombre de secondes écoulées depuis l'époque Unix (1er janvier 1970 00:00:00 GMT)

En même temps, vous pouvez également utiliser les constantes prédéfinies suivantes (disponibles depuis PHP 5.1.0) :

  • DATE_ATOM - Atom (par exemple : 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (par exemple : vendredi, 12-avr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (par exemple : 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (par exemple : ven, 12 avr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (par exemple : vendredi, 12-avr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (par exemple : ven, 12 avr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (par exemple : Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Identique à DATE_ATOM (à partir de PHP 5.1.3)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - Consortium W3C (par exemple : 2013-04-12T15:52:01+00:00)
timestamp Optionnel. Définit le timestamp Unix entier. Par défaut, c'est l'heure locale actuelle (time()).

Détails techniques

Valeur de retour : Retourne une chaîne de caractères de date formatée avec succès, ou renvoie E_WARNING et FALSE en cas d'échec.
Version PHP : 4+
Journal des mises à jour :

PHP 5.1.0 : Ajout des erreurs de fuseau horaire E_STRICT et E_NOTICE. La portée des timestamps est de 20:45:54 GMT le vendredi 13 décembre 1901 à 03:14:07 GMT le mardi 19 janvier 2038. Dans les versions précédentes de 5.1.0, sur certains systèmes (par exemple Windows), les timestamps sont limités à 01-01-1970 à 19-01-2038.

PHP 5.1.1 : Ajout des constantes de format de date/heure standard, utilisées pour spécifier format Paramètres.

Fonctions Date / Time PHP