DateTimeZone::getLocation

timezone_location_get

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

DateTimeZone::getLocation -- timezone_location_get — Возвращает информацию о местоположении для часового пояса

Описание

Объектно-ориентированный стиль

public DateTimeZone::getLocation(): array|false

Процедурный стиль

timezone_location_get(DateTimeZone $object): array|false

Функция возвращает информацию о местоположении часового пояса, включая код страны, широту, долготу и комментарии.

Список параметров

object: Только для процедурного стиля: объект DateTimeZone, который возвращает функция timezone_open().

Возвращаемые значения

Функция возвращает массив с информацией о местоположении часового пояса или 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. Элементы latitude и longitude — координаты города из идентификатора часового пояса, а элемент comments, если не равен значению false, — содержит подсказку о территории страны, на которой действует часовой пояс. Эта информация выводится в удобном для чтения пользователями виде.

Смотрите также

Функция DateTimeZone::listIdentifiers() - Возвращает численно индексированный массив со всеми идентификаторами часовых поясов для получения полного или частичного списка всех поддерживаемых идентификаторов часовых поясов.