Edit Report a Bug

    timezone_name_from_abbr

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

    timezone_name_from_abbr — Liefert den Namen einer Zeitzone, ausgehend von der Abkürzung und der UTC-Abweichung

    Beschreibung

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

    Parameter-Liste

    abbr

    Das Zeitzonenkürzel

    utcOffset

    Die Abweichung von GMT in Sekunden. Der Standardwert ist -1, was bedeutet, dass die erste gefundene Zeitzone zurückgegeben wird, die abbr entspricht. Andernfalls wird die exakte Abweichung gesucht und nur wenn diese nicht gefunden wird, wird die erste Zeitzone mit einer Abweichung zurückgegeben.

    isDST

    Der Sommerzeit-Indikator. Voreinstellung ist -1, was bedeutet, dass bei der Suche nicht berücksichtigt wird, ob die Zeitzone Sommerzeit hat oder nicht. Wenn dies auf 1 gesetzt ist, dann wird angenommen, dass utcOffset eine Abweichung mit Sommerzeit ist; wenn 0, dann wird angenommen, dass utcOffset eine Abweichung ohne Sommerzeit ist. Wenn abbr nicht existiert, wird die Zeitzone ausschließlich anhand von utcOffset und isDST gesucht.

    Rückgabewerte

    Gibt im Erfolgsfall den Namen der Zeitzone zurück. Bei einem Fehler wird false zurückgegeben.

    Beispiele

    Beispiel #1 Ein timezone_name_from_abbr()-Beispiel

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

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Europe/Berlin
Europe/Paris

    Siehe auch

    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