DateTimeZone::getLocation

timezone_location_get

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

説明

オブジェクト指向型

public arrayfalse DateTimeZone::getLocation()

手続き型

arrayfalse timezone_location_get(DateTimeZone $object)

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

パラメータ

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