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() 方法列印出來。