タイムゾーンの位置情報を返す

# DateTimeZone::getLocation

# timezone_location_get

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

DateTimeZone::getLocation -- timezone_location_get — タイムゾーンの位置情報を返す

### 説明

オブジェクト指向型

public function DateTimeZone::getLocation(): array|false

手続き型

function timezone_location_get(DateTimeZone `$object`): array|false

タイムゾーンの位置情報 (国コード、緯度/経度、コメント) を返します。

### パラメータ

`object`
  手続き型のみ: timezone_open() が返す DateTimeZone オブジェクト

### 戻り値

タイムゾーンについての位置情報を含む配列を返します。失敗した場合に `false` を返します

### 例

例1 DateTimeZone::getLocation() の例

    <?php
    $tz = new DateTimeZone("Asia/Jakarta");
    print_r($tz->getLocation());
    print_r(timezone_location_get($tz));

上の例の出力は以下となります。

    Array
    (
        [country_code] => ID
        [latitude] => -6.16667
        [longitude] => 106.8
        [comments] => Java, Sumatra
    )
    Array
    (
        [country_code] => ID
        [latitude] => -6.16667
        [longitude] => 106.8
        [comments] => Java, Sumatra
    )

`country_code` 要素には、ISO 3166-1 alpha-2 で定められた国コードがそれぞれ入っています。 `latitude` と `longitude` 要素には、タイムゾーンの識別子に含まれる都市の座標が入ります。 `comments` 要素には (`false` でない場合)、 指定された国でこのタイムゾーンが適用される場所のヒントが入ります。 この情報はエンドユーザー向けの表現に適しています。

### 参考

- タイムゾーンの識別子を全て、または一部を取得する DateTimeZone::listIdentifiers() - すべてのタイムゾーン識別子を含む配列を返す

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open