DateTimeZone::listAbbreviations

timezone_abbreviations_list

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

DateTimeZone::listAbbreviations -- timezone_abbreviations_listRetourne un tableau associatif, décrivant un fuseau horaire

Description

Style orienté objet

public static DateTimeZone::listAbbreviations(): array

Style procédural

La liste des abréviations retournée contient tous les usages historiques des abréviations, ce qui peut amener à des entrées correctes, mais confus. Il y a aussi des conflits, car PST est utilisé tous deux dans les États-Unis et les Philippines.

La liste que cette fonction retourne n'est par conséquent pas adapter pour construire un tableau d'option présentant un choix de fuseau horaire aux utilisateurs.

Note:

Les données pour cette fonction sont pré-compilées pour des raisons de performance, et ne sont pas mis à jour lors de l'utilisation d'une » timezonedb plus récente.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Retourne le tableau des abréviations des fuseaux horaires.

Exemples

Exemple #1 Exemple avec timezone_abbreviations_list()

<?php
$timezone_abbreviations
= DateTimeZone::listAbbreviations();
print_r($timezone_abbreviations["acst"]);
?>

Résultat de l'exemple ci-dessus est similaire à :

Array
(
    [0] => Array
        (
            [dst] => 1
            [offset] => -14400
            [timezone_id] => America/Porto_Acre
        )

    [1] => Array
        (
            [dst] => 1
            [offset] => -14400
            [timezone_id] => America/Eirunepe
        )

    [2] => Array
        (
            [dst] => 1
            [offset] => -14400
            [timezone_id] => America/Rio_Branco
        )

    [3] => Array
        (
            [dst] => 1
            [offset] => -14400
            [timezone_id] => Brazil/Acre
        )

)

Voir aussi

add a note add a note

User Contributed Notes 2 notes

up
62
jonathan at hogervorst dot info
10 years ago
This method returns an associative array containing some 'major' timezones (like CEST), which on their own contain more specific 'geographic' timezones (like Europe/Amsterdam).

If you're using these timezones and their offset/DST information, it's extremely important to realize the following:

*It seems like ALL DIFFERENT OFFSET/DST CONFIGURATIONS (including historical configurations) of each timezone are included!*

For example, Europe/Amsterdam can be found six times in the output of this function. Two occurrences (offset 1172/4772) are for the Amsterdam time used until 1937; two (1200/4800) are for the time that was used between 1937 and 1940; and two (3600/4800) are for the time used since 1940.

*Therefore, YOU CANNOT RELY ON THE OFFSET/DST INFORMATION RETURNED BY THIS FUNCTION as being currently correct/in use!*

If you want to know the current offset/DST of a certain timezone, you'll have to do something like this:

<?php
$now
= new DateTime(null, new DateTimeZone('Europe/Amsterdam'));
echo
$now->getOffset();
?>

P.S. I'm sorry for my use of caps lock in this post, but as this behavior is not described in the documentation, I considered it to be important enough to shout. Normally I don't do such things :)
up
-8
kingskippus at gmail dot com
15 years ago
Note that the dst field is of boolean type, so if you are doing an identity comparison, you need to test for true or false, not 0 or 1.  For example:

<?php
  $timezone_abbreviations
= DateTimeZone::listAbbreviations();
  foreach (
$timezone_abbreviations["est"] as $tz) {
    echo
$tz['timezone_id'];
   
// if ($tz['dst'] === 1) will always evaluate to false
   
if ($tz['dst'] === true) {
      echo
" (DST observed)<br />\n";
    }
   
// Could use else here, but for illustration...
   
if ($tz['dst'] === false) {
      echo
" (DST not observed)<br />\n";
    }
  }
?>
To Top