timezone_name_from_abbr()

Introduction

Dans cet article, nous couvrirons la syntaxe, les paramètres et la valeur de retour de la fonction PHP timezone_name_from_abbr(), ainsi que des exemples pratiques de son utilisation.

Comprendre la fonction PHP timezone_name_from_abbr()

La fonction timezone_name_from_abbr() de PHP est utilisée pour obtenir le nom du fuseau horaire à partir de son abréviation. Cette fonction retourne le nom du fuseau horaire en cas de succès ou false en cas d'échec.

Note : Cette fonction est notoirement peu fiable car de nombreuses abréviations de fuseaux horaires sont ambigües ou non standard. Le manuel PHP recommande d'utiliser DateTimeZone pour les applications en production. Lors de l'utilisation de timezone_name_from_abbr(), fournissez toujours le paramètre $gmtOffset pour garantir des résultats cohérents.

Syntaxe

La syntaxe de la fonction timezone_name_from_abbr() est la suivante :

La syntaxe de la fonction PHP timezone_name_from_abbr()

<‌?php

string|false timezone_name_from_abbr(string $abbr, int $gmtOffset = -1, int $isdst = -1)

Paramètres

La fonction prend trois paramètres comme suit :

• $abbr - Le nom abrégé du fuseau horaire.
• $gmtOffset - Le décalage GMT du fuseau horaire en secondes. Ce paramètre est optionnel, mais fortement recommandé. S'il n'est pas fourni, la fonction peut retourner false ou un fuseau horaire incorrect en raison d'abréviations ambigües.
• $isdst - Un indicateur indiquant si l'heure d'été est en vigueur. Ce paramètre est optionnel et, s'il n'est pas fourni, la fonction utilisera la valeur par défaut du système.

Valeur de retour

La fonction timezone_name_from_abbr() retourne le nom du fuseau horaire en cas de succès ou false en cas d'échec.

Exemples

Examinons quelques exemples pratiques de l'utilisation de la fonction timezone_name_from_abbr() en PHP.

Exemple d'utilisation de la fonction timezone_name_from_abbr() en PHP

<‌?php

// Providing the GMT offset ensures reliable results
$tz1 = timezone_name_from_abbr('EST', -18000);
echo $tz1 !== false ? $tz1 : 'Unknown timezone'; // outputs "America/New_York"

$tz2 = timezone_name_from_abbr('PST', -28800);
echo $tz2 !== false ? $tz2 : 'Unknown timezone'; // outputs "America/Los_Angeles"

Try it Yourself »

Dans les exemples ci-dessus, nous transmettons les noms de fuseaux horaires abrégés EST et PST ainsi que leurs décalages GMT respectifs en secondes. La fonction retourne les noms complets correspondants, America/New_York et America/Los_Angeles respectivement. Vérifiez toujours la présence de false pour gérer les cas où l'abréviation n'est pas reconnue.

Conclusion

Nous avons couvert la syntaxe et l'utilisation de la fonction PHP timezone_name_from_abbr(). Cette fonction peut convertir les noms de fuseaux horaires abrégés en leurs identifiants complets, bien qu'il soit généralement recommandé d'utiliser DateTimeZone pour des applications robustes. Nous espérons que cet article vous a été utile.

Pratique

Que retourne la fonction timezone_name_from_abbr() en PHP ?

Elle retourne le nom du fuseau horaire correspondant à une abréviation donnée.Elle retourne l'abréviation d'un nom de fuseau horaire donné.Elle retourne la différence en heures entre l'heure locale et le GMT.Elle vérifie si une abréviation donnée est valide pour un fuseau horaire.