date_create_from_format()函式—用法及示例

函式名：date_create_from_format()

適用版本：PHP 5 >= 5.3.0, PHP 7

用法：date_create_from_format(string $format, string $time, DateTimeZone $timezone = null) : DateTime|false

說明：date_create_from_format() 函式根據指定的格式將一個日期時間字串解析為 DateTime 物件。該函式會根據給定的格式字串解析時間字串，然後返回一個 DateTime 物件。如果解析失敗則返回 false。

引數：

• $format：指定時間字串的格式。該格式與 PHP 的 date() 或 strftime() 的格式字串類似，但也包含一些額外的字元。具體的格式化符號可以參考 DateTime 官方文件。
• $time：待解析的時間字串。
• $timezone（可選）：要應用的時區。如果沒有提供時區，則使用伺服器的預設時區。

返回值：

• 如果成功解析，返回一個 DateTime 物件。
• 如果解析失敗，返回 false。

示例：

$dateString = '2021-05-20 12:34:56';
$format = 'Y-m-d H:i:s';
$timezone = new DateTimeZone('Asia/Shanghai');

$date = date_create_from_format($format, $dateString, $timezone);
if ($date) {
    echo $date->format('Y-m-d H:i:s'); // 輸出：2021-05-20 12:34:56
} else {
    echo '解析失敗';
}

在上面的示例中，我們使用 date_create_from_format() 函式將字串 $dateString 解析為 DateTime 物件，並指定了格式 $format 為 'Y-m-d H:i:s'，時區為 'Asia/Shanghai'。如果解析成功，則列印出格式化後的日期時間字串；否則列印出 '解析失敗'。