DateTimeZone::__construct
timezone_open
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTimeZone::__construct -- timezone_open — Створює новий об'єкт DateTimeZone
Опис
Об'єктно-орієнтований стиль
public DateTimeZone::__construct(string$timezone) .
Процедурний стиль
timezone_open(string $timezone): DateTimeZone|false
Створює новий об'єкт DateTimeZone.
Об'єкт DateTimeZone надає доступ до трьох різних типів правил тимчасових зон: Зміщення UTC (тип ), сокращение часового пояса (тип ) иідентифікатори часових поясів, опубліковані в базі даних часових поясів IANA (тип 3
Об'єкт DateTimeZone може бути приєднаний до об'єктів DateTime і DateTimeImmutable, щоб мати змогу відображати часовий пояс, розташований у цих об'єктах у локальному часовому поясі.
Список параметрів
timezone
Одне з підтримуваних імен часових поясів або значення усунення (+0200) або абревіатура часового поясу (BST).
Значення, що повертаються
У разі успішного виконання повертає DateTimeZone. Процедурний стиль повертає **false**в случае возникновения ошибки.
Помилки
Якщо часовий пояс не розпізнається як дійсний, викидається виняток DateInvalidTimeZoneException. До PHP 8.3 натомість викидався виняток Exception
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Тепер через неприпустимі значення замість загального виключення Exception викидається виняток DateInvalidTimeZoneException |
Приклади
Приклад #1 Створення та приєднання DateTimeZone до DateTimeImmutable
Результат виконання наведеного прикладу:
Thu, 02 Jun 2022 16:44:48 +0100 — Europe/London
Thu, 02 Jun 2022 20:29:48 +0445 — +04:45
Thu, 02 Jun 2022 09:44:48 -0600 — -06:00
Thu, 02 Jun 2022 17:44:48 +0200 — CEST
Приклад #2 Перехоплення помилок під час створення екземпляра DateTimeZone
Результат виконання наведеного прикладу:
DateTimeZone::__construct() [datetimezone.--construct]: Unknown or bad timezone (Mars/Phobos)
DateTimeZone::__construct() [datetimezone.--construct]: Unknown or bad timezone (Jupiter/Europa)