PHP gmdate() Fonction

❮ Référence PHP Date/Heure

Exemple

Formate une date et une heure en GMT/UTC et renvoie les chaînes de date formatées :

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

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

Définition et Utilisation

La fonction gmdate() formate une date et une heure en GMT/UTC et renvoie la chaîne de date formatée.


Syntaxe

gmdate( format, timestamp)

Valeurs des Paramètres

Paramètre Description
format Obligatoire. 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 - Indique 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) - Indique 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, il s'agit de l'heure locale actuelle (time())


Détails Techniques

Valeur de Retour : Renvoie une chaîne de date formatée en cas de succès. FALSE en cas d'échec + un E_WARNING
Version PHP : 4+
Journal des Modifications PHP : PHP 5.1 : La plage valide de timestamp est maintenant de ven, 13 déc 1901 20:45:54 GMT à mar, 19 jan 2038 03:14:07 GMT. Avant la version 5.1, le timestamp était limité de 01-01-1970 à 19-01-2038 sur certains systèmes (par exemple, Windows).
PHP 5.1.1 : Ajout des constantes des formats de date/heure standard qui peuvent être utilisés pour spécifier le paramètre format

❮ Référence PHP Date/Heure