Submit a Pull Request Report a Bug

    timezone_name_from_abbr

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

    timezone_name_from_abbr — Gibt den Namen der Zeitzonenabkürzung zurück

    Beschreibung

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

    Parameter-Liste

    abbr

    Zeitzonenabkürzung.

    utcOffset

    Offset zu GMT in Sekunden. Standardwert ist -1, das bedeutet, dass die erste gefundene Zeitzone, die abbr entspricht, zurückgegeben wird. Andernfalls wird der exakte Offset gesucht und nur, wenn dieser nicht gefunden wird, wird die erste Zeitzone mit einem Offset zurückgegeben.

    isDST

    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 ein Offset mit Sommerzeit ist; wenn 0, dann wird angenommen, dass utcOffset ein Offset 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. Im Fehlerfall 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
    15 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
    7 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