Edit Report a Bug

    timezone_name_from_abbr

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

    timezone_name_from_abbr — Retourne le nom d'un fuseau horaire à partir de son abréviation et de son décalage UTC

    Description

    timezone_name_from_abbr(string $abbr, int $utcOffset = -1, int $isDST = -1): string|false

    Liste de paramètres

    abbr

    Abréviation du fuseau horaire.

    utcOffset

    Décalage à partir du GMT en seconde. La valeur par défaut est -1 ce qui signifie que le premier fuseau horaire trouvé correspondant à abbr est retourné. Autrement, le décalage exact est recherché et seulement s'il n'est pas trouvé alors le premier fuseau horaire avec n'importe quel décalage est retourné.

    isDST

    Indicateur d'heure d'été/heure d'hiver. Par défaut -1 qui signifie que le décalage heure d'été/heure d'hiver n'est pas pris en compte dans la recherche même si le fuseau le gère. Si mis à 1, alors le utcOffset est supposé comprendre le décalage heure d'été /heure d'hiver; si 0 alors utcOffset est supposé représenter un décalage ne prennant pas en compte l'heure d'été/hiver. Si abbr n'existe pas alors le fuseau horaire est cherché uniquement au moyen de utcOffset et isDST.

    Valeurs de retour

    Retourne un nom de fuseau horaire en cas de succès ou false si une erreur survient.

    Exemples

    Exemple #1 Exemple avec timezone_name_from_abbr()

    <?php
    echo timezone_name_from_abbr("CET") . "\n";
    echo     timezone_name_from_abbr("", 3600, 0) . "\n";
    ?>

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

    Europe/Berlin
Europe/Paris

    Voir aussi

    add a note add a note

    User Contributed Notes 4 notes

    up
    8
    chris at mretc dot net
    16 years ago
    timezone_name_from_abbr() sometimes returns FALSE instead of an actual timezone: http://bugs.php.net/44780

    It's possible to workaround it for some cases by getting the timezone name from timezone_abbreviations_list(). For example, if you have the GMT offset and want a timezone name:

    <?php
    /* Takes a GMT offset (in hours) and returns a timezone name */
    function tz_offset_to_name($offset)
    {
                $offset *= 3600; // convert hour offset to seconds
                $abbrarray = timezone_abbreviations_list();
            foreach (    $abbrarray as $abbr)
            {
                    foreach (    $abbr as $city)
                    {
                            if (    $city['offset'] == $offset)
                            {
                                    return     $city['timezone_id'];
                            }
                    }
            }

            return     FALSE;
    }
    ?>
    up
    2
    Jon Stovell
    8 years ago
    In some cases, timezone_name_from_abbr() may return a "historical" (i.e. deprecated) timezone identifier rather than the current standard one for a given location. For example:
    <?php
    echo timezone_name_from_abbr('EASST'); // prints "Chile/EasterIsland" instead of "Pacific/Easter"
    ?>

    This means that the returned timezone identifier is not guaranteed to be in the results of timezone_identifiers_list() unless you include the "backwards compatible" timezones.
    <?php
    var_dump    (in_array(timezone_name_from_abbr('EASST'), timezone_identifiers_list())); // (bool)false
    var_dump(in_array(timezone_name_from_abbr('EASST'), timezone_identifiers_list(DateTimeZone::ALL_WITH_BC))); // (bool)true
    ?>
    up
    1
    Master Tablu
    15 years ago
    Another way to do this is to wrap the function in a class that extends the DateTimeZone class:

    <?php

    /**
    * Helps with timezones.
    * @link http://us.php.net/manual/en/class.datetimezone.php
    *
    * @package  Date
    */
    class Helper_DateTimeZone extends DateTimeZone
    {
            /**
         * Converts a timezone hourly offset to its timezone's name.
         * @example $offset = -5, $isDst = 0 <=> return value = 'America/New_York'
         *
         * @param float $offset The timezone's offset in hours.
         *                      Lowest value: -12 (Pacific/Kwajalein)
         *                      Highest value: 14 (Pacific/Kiritimati)
         * @param bool  $isDst  Is the offset for the timezone when it's in daylight
         *                      savings time?
         *
         * @return string The name of the timezone: 'Asia/Tokyo', 'Europe/Paris', ...
         */
            final public static function tzOffsetToName($offset, $isDst = null)
        {
            if (    $isDst === null)
            {
                    $isDst = date('I');
            }

                $offset *= 3600;
                $zone    = timezone_name_from_abbr('', $offset, $isDst);

            if (    $zone === false)
            {
                foreach (    timezone_abbreviations_list() as $abbr)
                {
                    foreach (    $abbr as $city)
                    {
                        if ((bool)    $city['dst'] === (bool)$isDst &&
                                strlen($city['timezone_id']) > 0    &&
                                $city['offset'] == $offset)
                        {
                                $zone = $city['timezone_id'];
                            break;
                        }
                    }

                    if (    $zone !== false)
                    {
                        break;
                    }
                }
            }
       
            return     $zone;
        }
    }
    ?>

    Then you could do something like this:

    <?php
    $Dtz     = new Helper_DateTimeZone(Helper_DateTimeZone::tzOffsetToName(-5));
    var_dump($Dtz->getName());

    string(16) "America/New_York"
    ?>
    up
    -1
    atrauzzi at gmail dot com
    8 years ago
    Fun fact: (60*60) * -2 always seems to return null.

    Perhaps because there's no timezone that corresponds to UTC -2.
    add a note add a note
    To Top