PHP DateTime createFromFormat()用法及代碼示例

DateTime::createFromFormat()函數是PHP中的一個內置函數，它返回一個代表日期和時間格式的新DateTime對象。

用法:

• 麵向對象的樣式：

  DateTime DateTime::createFromFormat( string $format, 
                                      string $time, DateTimeZone $timezone )

• 程序風格：

  DateTime date_create_from_format( string $format, 
                                      string $time, DateTimeZone $timezone )

參數：此函數使用上述和以下所述的三個參數：

• $format:它是必需的參數，用於指定日期格式。以下參數字符串以格式使用。
  1. Day:
     • d和j：它描述了一個月中的某天。它包含兩位數字(帶或不帶前導零)。
     • D和l：一天的文字表示。
     • S：每月的英語序數後綴，兩個字符。處理時將其忽略。
     • z：一年中的一天(從0開始)
  2. Month:
     • F和M：一個月的文本表示形式，例如一月或九月
     • m和n：一個月的數字表示形式，帶或不帶前導零
  3. Year:
     • Y：一年的完整數字表示形式，4位數字
     • y：一年的兩位數表示形式(假定範圍為1970-2069(含))
  4. Time:
     • a和A：前子午後
     • g和h：一小時的12小時格式，帶或不帶前導零
     • G和H：一小時的24小時格式，帶或不帶前導零
     • i: 以零開頭的分鍾
     • s：秒，前導零
     • u: 微秒(最多六位數)
  5. Timezone:
     • e，O，P和T：時區標識符，或以小時為單位的UTC差異，或以小時和分鍾之間的冒號與UTC的差異，或時區縮寫
  6. 完整日期/時間：
     • U：自Unix時代以來的秒數(格林尼治標準時間1970年1月1日00:00:00)
  7. 空格和分隔符：
     • (space):一個空格或一個標簽
     • ＃：以下分隔符號之一：;，：，/，。、、-，(或)
     • ;，：， /， 。，，， -， ( 或者 )：指定的字符。
     • ？：隨機字節
     • *：隨機字節，直到下一個分隔符或數字
     • ！：將所有字段(年，月，日，小時，分鍾，秒，分數和時區信息)重置為Unix Epoch
     • |：如果尚未解析所有字段(年，月，日，小時，分鍾，秒，分數和時區信息)，則將其重置為Unix Epoch
     • +：如果存在此格式說明符，則字符串中的尾隨數據不會導致錯誤，但會發出警告
• $time:此參數包含代表時間的字符串。
• $timezone:此參數保存DateTimeZone對象，該對象表示所需的時區。

返回值：成功時此函數返回新的DateTime對象，失敗時返回False。

以下示例程序旨在說明PHP中的DateTime::createFromFormat()函數：

程序1:

<?php 
  
// Calling the DateTime:createFromFormat() function 
// with the format 'j-M-Y' and given DateTime is  
$datetime = DateTime::createFromFormat('j-M-Y', '30-September-2019'); 
  
// Getting the new formatted datetime  
echo $datetime->format('Y-m-d'); 
?>

2019-09-30

程序2:

<?php 
  
// Calling the DateTime:createFromFormat() function 
// with the format 'j-M-Y' and given DateTime is  
$datetime = DateTime::createFromFormat('j-M-Y', '1-oct-2019'); 
  
// Getting the new formatted datetime  
echo $datetime->format('d-m-Y H:i:s'); 
?>

01-10-2019 11:10:06

參考： https://www.php.net/manual/en/datetime.createfromformat.php