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