PHP date_create_immutable_from_format() Function Usage and Examples

PHP Date & Time Function Manual

Функция date_create_immutable_from_format() парсит строку времени по указанному формату

Определение и использование

Функция date_create_immutable_from_format() имеет别名 DateTimeImmutable::createFromFormat(). Она принимает строку времени и строку формата в качестве параметров, парсит заданную строку времени в указанном формате и возвращает объект DateTimeImmutable.

Синтаксис

date_create_immutable_from_format($date, $time [,$timezone])

Параметр

Возвратное значение

Функция date_create_immutable_from_format() возвращает объект DateTime, представляющий интерпретированное время. Если функция не удается, она возвращает булево значениеfalse.

Версия PHP

Эта функция была добавлена в PHP версии 5.5.0 и может использоваться во всех более поздних версиях.

Онлайн пример

Следующий пример демонстрирует-date_create_immutable_from_format()Использование функции-

<?php
　　　//Создание объекта DateTime
　　　$date = "1989-08-25";
　　　$format = "Y-m-d";
　　　$res = date_create_immutable_from_format($format, $date);
　　　print("Дата:　".date_format($res, "Y-m-d"));
?>

Результат вывода

Дата:　1989-08-25

Онлайн пример

Теперь, давайте попробуем передать опциональный параметр timezone-

<?php
　　　//Создание объекта DateTime
　　　$date = "1989-08-25";
　　　$format = "Y-m-d";
　　　$tz = new DateTimeZone('Asia/Shanghai');　　
　　　$res = date_create_immutable_from_format($format, $date, $tz);
　　　print　date_format($res, "Y-m-d");
?>

Результат вывода

1989-08-25

Онлайн пример

Следующий пример демонстрирует использование функции date_create_immutable_from_format() с различными форматами-

<?php
　　　$res1 = date_create_immutable_from_format("j.n.Y", "25.8.2014");
　　　print(date_format($res1, "Y-m-d"));
　　　print("\n");
　　　$res2 = date_create_immutable_from_format('Y-d-m　H:i:s', '2014-25-08　12:20:25');
　　　print(date_format($res2, "Y-m-d　H:i:s"));　　
?>

Это будет производить следующий вывод-

2014-08-25
2014-08-25　12:20:25