DateTimeZone::listAbbreviations

timezone_abbreviations_list

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

DateTimeZone::listAbbreviations -- timezone_abbreviations_list — 夏時間、オフセットおよびタイムゾーン名を含む連想配列を返す

説明

オブジェクト指向型

public static function DateTimeZone::listAbbreviations(): array

手続き型

function timezone_abbreviations_list(): array

この関数が返す省略形のリストは、歴史的に使われてきた値を全て含んでいます。これは正しい値ではあるものの、混乱を招くものがあります。値が衝突しているものもあります。たとえば PST はアメリカ合衆国(US)とフィリピンの双方で使われています。

よって、この関数が返すリストは、ユーザーにタイムゾーンを選択させる表示オプションを構築する目的には適していません。

注意:
この関数で使われるデータは、パフォーマンス上の理由でプリコンパイルされています。よって、より新しい » timezonedb を使っていても更新されません。

パラメータ

この関数にはパラメータはありません。

戻り値

成功した場合に、タイムゾーンの情報を含んだ配列を返します。

例

例1 timezone_abbreviations_list() の例

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

上の例の出力は、たとえば以下のようになります。

Array
(
    [0] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/Adelaide
        )

    [1] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/Broken_Hill
        )

    [2] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/Darwin
        )

    [3] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/North
        )

    [4] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/South
        )

    [5] => Array
        (
            [dst] =>
            [offset] => 34200
            [timezone_id] => Australia/Yancowinna
        )

)

参考

timezone_identifiers_list() - DateTimeZone::listIdentifiers のエイリアス

関連キーワード:

timezone DateTimeZone abbreviations offset Australia タイムゾーン list listAbbreviations オフセット連想 listIdentifiers 夏時夏時間 getTransitions オブジェクト指向 static 手続き省略歴史的混乱衝突アメリカ合衆国フィリピン双方選択