# gmstrftime

(PHP 4, PHP 5, PHP 7, PHP 8)

gmstrftime — Formate une date/heure GMT/TUC en fonction de la configuration locale

Avertissement

Cette fonction est OBSOLÈTE à partir de PHP 8.1.0. Il est fortement recommandé de les éviter.

Les alternatives à cette fonction incluent :

- gmdate()
- IntlDateFormatter::format()

### Description

#[\Deprecated]
gmstrftime(string `$format`, ?int `$timestamp` = `null`): string|false

gmstrftime() se comporte exactement comme strftime() hormis le fait que l'heure utilisée est celle de Greenwich (`Greenwich Mean Time`, GMT). Par exemple, dans la zone `Eastern Standard Time` (est des USA) est GMT -0500, la première ligne de l'exemple ci-dessous affiche `"Dec 31 1998 20:00:00"`, tandis que la seconde affiche `"Jan 01 1999 01:00:00"`.

Avertissement

Cette fonction dépend des informations locales du système d'exploitation, qui peuvent être incohérentes ou ne pas être disponibles du tout. Utilisez plutôt la méthode IntlDateFormatter::format().

### Liste de paramètres

`format`

  Voir la description de la fonction strftime().

`timestamp`

  Le paramètre optionnel `timestamp` est un timestamp Unix de type entier qui vaut par défaut l'heure courante locale si `timestamp` est omis ou `null`. En d'autres termes, il vaut par défaut la valeur de la fonction time().

### Valeurs de retour

Retourne une chaîne de caractères formatée suivant le format donné par le paramètre `timestamp` ou la date courante si aucun paramètre `timestamp` n'est fourni. Les noms des mois, des jours de la semaine et des autres chaînes dépendant d'une localisation donnée, respectent la localisation courante définie par la fonction setlocale(). En cas d'échec, `false` est retourné.

### Historique

Version | Description
--- | ---
8.0.0 | `timestamp` est désormais nullable.

### Exemples

Exemple #1 Exemple avec gmstrftime()

`<?php
setlocale(LC_TIME, 'en_US');
echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
?>`

### Voir aussi

- IntlDateFormatter::format() - Formate la date et l'heure sous forme de chaîne
- DateTimeInterface::format() - Retourne une date formatée suivant le format fourni
- strftime() - Formate une date/heure locale avec la configuration locale