[函数]date_create_immutable_from_format()函数—用法及示例

函数名：date_create_immutable_from_format()

适用版本：PHP 5 >= 5.5.0, PHP 7

用法：date_create_immutable_from_format() 函数通过一个指定的格式化字符串创建一个新的日期时间对象，并返回一个不可变的 DateTimeImmutable 对象。

语法：date_create_immutable_from_format(string $format, string $datetime, DateTimeZone $timezone = null): DateTimeImmutable|false

参数：

• $format：指定日期时间的格式化字符串。可以使用和date()函数一样的格式化选项，也可以使用自定义的格式化选项。具体的格式化选项请参考官方文档说明。
• $datetime：一个符合格式化字符串$format的字符串，表示具体的日期时间。
• $timezone（可选）：一个 DateTimeZone 对象，用于指定日期时间的时区。如果不传该参数，则使用默认时区。

返回值：返回一个不可变的 DateTimeImmutable 对象，表示给定的日期时间。如果创建失败，则返回布尔值 false。

示例：

$datetimeStr = "2021-10-01 10:15:30";
$format = "Y-m-d H:i:s";

$datetime = date_create_immutable_from_format($format, $datetimeStr);
if ($datetime !== false) {
    echo $datetime->format("Y-m-d H:i:s"); // 输出：2021-10-01 10:15:30
} else {
    echo "日期时间创建失败";
}

以上例子中，我们使用格式化字符串 "Y-m-d H:i:s" 来指定日期时间的格式，然后将一个符合该格式的字符串 "2021-10-01 10:15:30" 传递给函数 date_create_immutable_from_format()。函数会将该字符串转换为一个 DateTimeImmutable 对象 $datetime，并通过 $datetime->format() 方法打印出来。