PHP date_create_immutable_from_format() 函数

定义和用法

date_create_immutable_from_format() 函数是 DateTimeImmutable::createFromFormat() 的别名。它接受一个时间字符串和格式字符串作为参数，按照指定的格式解析给定的时间字符串，并返回一个 DateTimeImmutable 对象。

语法

date_create_immutable_from_format(date,time [,$timezone])

参数

序号	参数与描述
1	format(必填) 这是一个字符串值，表示您需要解析给定时间字符串的格式。
2	time(必填) 这是一个字符串值，表示您需要解析的时间。
3	timezone(可选) 这是DateTimeZone类的对象，表示所需的时区。

返回值

PHP date_create_immutable_from_format() 函数返回一个表示解析时间的 DateTime 对象。如果解析失败，则该函数返回布尔值 false。

PHP 版本

该函数首次引入于 PHP 版本 5.5.0，并适用于所有后续版本。

示例

以下示例演示了 date_create_immutable_from_format() 函数的用法 –

<?php
   //Creating a DateTime object
   date = "25-Mar-1989";format = "d-M-Y";
   res = date_create_immutable_from_format(format, date);
   print("Date: ".date_format(res, "Y-m-d"));
?>

这将产生以下结果 –

Date: 1989-03-25

示例

现在，让我们尝试传递可选的时区参数 –

<?php
   //Creating a DateTime object
   date = "25-Mar-1989";format = "d-M-Y";
   tz = new DateTimeZone('Indian/Mahe');res = date_create_immutable_from_format(format,date, tz);
   print date_format(res, "Y-m-d");
?>

这将产生以下结果−

1989-03-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"));  
?>