gmdate() fonction php Définition
PHP Version: 4+
Évolution de PHP : PHP 5.1 : La plage de validité de l'horodatage est maintenant comprise entre Fri, 13 Dec 1901 20:45:54 GMT et Tue, 19 Jan 2038 03:14:07 GMT. Avant la version 5.1, l'horodatage était limité du 01-01-1970 au 19-01-2038 sur certains systèmes (par exemple Windows).
PHP 5.1.1 : Ajout des constantes des formats de date et d'heure standards qui peuvent être utilisées pour spécifier le paramètre format
La fonction gmdate() est identique à la fonction date(), seulement le fait que le temps retourné est GMT (Greenwich Mean Time).
Retourne une date formatée. Si une valeur non numérique est utilisée pour le paramètre timestamp, FALSE est retourné et une erreur de niveau E_WARNING sera émise.
La fonction gmdate() et la fonction date() sont pratiquement similaires, à la différence que gmdate() renvoie le temps en utilisant le fuseau horaire GMT (Greenwich Mean Time).
gmdate() fonction php Syntaxe
gmdate(format,timestamp)
Liste de paramètres de la fonction gmdate()
Paramètre | Description |
format | Obligatoire. Spécifie le format de la chaîne de date produite. Les caractères suivants peuvent être utilisés :
- d - Le jour du mois (de 01 à 31)
- D - Représentation textuelle d'un jour (trois lettres)
- j - Le jour du mois sans les zéros initiaux (de 1 à 31)
- l (L minuscule) - 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 - Représentation textuelle complète d'un mois (de janvier à décembre)
- m - Représentation numérique d'un mois (de 01 à 12)
- M - Représentation textuelle courte d'un mois (trois lettres)
- n - Représentation numérique d'un mois, sans les zéros initiaux (de 1 à 12)
- t - Le nombre de jours dans le mois donné
- L - S'il s'agit d'une année bissextile (1 si c'est une année bissextile, 0 sinon)
- o - Le numéro de l'année ISO-8601
- Y - Une représentation à quatre chiffres d'une année
- y - Représentation à deux chiffres d'une année
- a - AM ou PM en minuscules
- A - AM ou PM en majuscules
- B - Heure Swatch Internet (000 à 999)
- g - Format 12 heures d'une heure (1 à 12)
- G - Format 24 heures d'une heure (0 à 23)
- h - Format 12 heures de l'heure (01 à 12)
- H - Format 24 heures de l'heure (00 à 23)
- i - Minutes avec zéros en tête (00 à 59)
- s - Secondes, avec des zéros en tête (00 à 59)
- u - Microsecondes (ajouté en PHP 5.2.2)
- e - L'identifiant du fuseau horaire (Exemples : UTC, GMT, Atlantic/Azores)
- I (i majuscule) - Si la date est à l'heure d'été (1 si heure d'été, 0 sinon)
- O - Différence par rapport à l'heure de Greenwich (GMT) en heures (exemple : +0100)
- P - Différence avec l'heure de Greenwich (GMT) en heures:minutes (ajouté en PHP 5.1.3)
- T - Abréviations des fuseaux horaires (Exemples : EST, MDT)
- Z - Décalage du 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, Fri, 12 Apr 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 - Atome (exemple : 2013-04-12T15:52:01+00:00)
- DATE_COOKIE - Cookies HTTP (exemple : Friday, 12-Apr-13 15:52:01 UTC)
- DATE_ISO8601 - ISO-8601 (exemple : 2013-04-12T15:52:01+0000)
- DATE_RFC822 - RFC 822 (exemple : Fri, 12 Apr 13 15:52:01 +0000)
- DATE_RFC850 - RFC 850 (exemple : Friday, 12-Apr-13 15:52:01 UTC)
- DATE_RFC1036 - RFC 1036 (exemple : Fri, 12 Apr 13 15:52:01 +0000)
- DATE_RFC1123 - RFC 1123 (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 (depuis PHP 5.1.3)
- DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
- DATE_W3C - World Wide Web Consortium (exemple : 2013-04-12T15:52:01+00:00)
|
timestamp |
Le paramètre optionnel "timestamp" est un nombre entier représentant un timestamp Unix. Lorsqu'il est omis ou défini comme null, il prend automatiquement la valeur de l'heure locale actuelle. En d'autres termes, si aucune valeur n'est fournie, le paramètre "timestamp" sera défini par défaut sur le résultat de la fonction time() qui représente l'heure courante en secondes depuis le 1er janvier 1970. |
gmdate() fonction php Exemple pratique d'utilisation
Formater une date et une heure GMT/UTC et renvoyer les chaînes de dates formatées :
Exemple : 📋 Copier le code
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<title></title>
</head>
<body>
<?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") . "<br>";
//affiche Le 3 octobre 1975 un jeudi
echo "Le 3 octobre 1975 était un ".gmdate("l", mktime(0,0,0,10,3,1975)) . "<br>";
// Utiliser une constante dans le paramètre de format
echo gmdate(DATE_RFC822) . "<br>";
// affiche quelque chose comme : 1975-10-03T00:00:00+00:00
echo gmdate(DATE_ATOM,mktime(0,0,0,10,3,1975));
?>
</body>
</html>
Dans ce code les fonctions "gmdate" sont utilisées pour afficher les dates et les heures en temps universel (GMT/UTC).
Voir aussi : La fonction gmmktime
Reference de date/heure de PHP