PHP date_create_immutable_from_format() 函式

定義和用法

這個 date_create_immutable_from_format() 函式是 DateTimeImmutable::createFromFormat() 的別名。它接受時間字串和格式字串作為引數，根據指定的格式解析給定的時間字串，並返回一個 DateTimeImmutable 物件。

語法

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

引數

返回值

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

這將產生以下輸出：

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