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

# 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]
function 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, lorsque 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. Utiliser 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 la chaîne de format donnée, en utilisant le paramètre `timestamp` donné ou l'heure locale courante si aucun horodatage 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, 'es_ES.UTF-8');
    date_default_timezone_set('EST');

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

L'exemple ci-dessus va afficher :

    Deprecated: Function strftime() is deprecated since 8.1, use IntlDateFormatter::format() instead in script on line 6
    diciembre 31 1998 20:00:00

    Deprecated: Function gmstrftime() is deprecated since 8.1, use IntlDateFormatter::format() instead in script on line 7
    enero 01 1999 01:00:00

### 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open