DateTimeImmutable::__construct
date_create_immutable
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::__construct -- date_create_immutable — Повертає новий об'єкт DateTimeImmutable
Опис
Об'єктно-орієнтований стиль
public DateTimeImmutable::__construct(string$datetime = "now", ?DateTimeZone $timezone null) .
Процедурний стиль
date_create_immutable(string $datetime = "now", ?DateTimeZone $timezone = null): DateTimeImmutable|false
Повертає новий об'єкт DateTimeImmutable.
Список параметрів
datetime
Рядок дати/часу. Пояснення коректних форматів наведено в розділі Формати дати та часу
Для получения текущего времени в параметрtimezone можна передати рядок "now"
timezone
Об'єкт DateTimeZone, представляющий часовой пояс параметраdatetime
Якщо параметр timezone опущений або дорівнює null, буде використано поточний часовий пояс.
Зауваження :
Параметр
timezoneі поточний часовий пояс буде проігноровано, якщо параметрdatetimeабо є тимчасовою міткою UNIX (наприклад,@946684800), або вказаний часовий пояс (наприклад,2010-01-28T15:00:00+02:00или2010-07-05T06:00:00Z
Значення, що повертаються
Повертає новий екземпляр DateTimeImmutable.
Помилки
Якщо буде передано рядок з неправильною датою/часом, буде викинуто виняток DateMalformedStringException. До PHP 8.3 викидався виняток Exception
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Тепер замість винятку Exception викидається виняток DateMalformedStringException, якщо передано неправильний рядок. |
| 7.1.0 | Відтепер мікросекунди заповнюються фактичним значенням. Чи не '00000'. |
Приклади
Приклад #1 Приклад використання DateTimeImmutable::__construct()****
Об'єктно-орієнтований стиль
Процедурний стиль
Результат виконання наведених прикладів:
2000-01-01
Приклад #2 Тонкощі DateTimeImmutable::__construct()
Висновок наведеного прикладу буде схожим на:
2000-01-01 00:00:00-05:00
2000-01-01 00:00:00+12:00
2010-04-24 10:24:16-04:00
2010-04-25 02:24:16+12:00
2000-01-01 00:00:00+00:00
2000-03-01 00:00:00-05:00
Приклад #3 Зміна пов'язаного часового поясу
Висновок наведеного прикладу буде схожим на:
2022/08/12 23:49:23
Приклад #4 Використання відносного рядка дати/часу
Висновок наведеного прикладу буде схожим на:
2021/08/12 15:43:51