[函数]DateTimeInterface::format()函数—用法及示例

函数名称：DateTimeInterface::format() 

适用版本：PHP 5 >= 5.5.0, PHP 7, PHP 8

函数描述： DateTimeInterface::format() 方法用于将日期和时间对象的值格式化为指定的字符串格式。

用法： DateTimeInterface::format(string $format): string|false

参数：

• $format: 必需，用于指定日期和时间的输出格式。
• 返回值：返回格式化后的日期和时间字符串。如果出现错误，则返回 false。

示例：

// 创建一个 DateTime 对象
$date = new DateTime('2022-01-01 12:30:45');

// 使用 format() 方法将日期格式化为指定格式
$formattedDate = $date->format('Y-m-d H:i:s');
echo $formattedDate; // 输出：2022-01-01 12:30:45

// 格式化为另一种常用格式
$formattedDate2 = $date->format('F j, Y, g:i a');  
echo $formattedDate2; // 输出：January 1, 2022, 12:30 pm

// 使用 format() 方法获取日期和时间的部分值
$year = $date->format('Y');
$month = $date->format('m');
$day = $date->format('d');
echo "$year-$month-$day"; // 输出：2022-01-01

// 使用 format() 方法获取日期和时间的某些特殊值
$dayOfWeek = $date->format('l'); // 获取星期几
$timezone = $date->format('e'); // 获取时区
echo "Today is $dayOfWeek. Timezone: $timezone"; // 输出：Today is Saturday. Timezone: UTC

请注意：

• 参数 $format 中的格式代码可以根据需求进行组合，具体的格式代码可以参考 PHP 官方文档中关于日期和时间格式的部分。
• 如果传入的日期和时间对象无效，或者格式化失败，format() 方法会返回 false。
• DateTimeInterface 是 DateTime 类和 DateTimeImmutable 类的父接口，format() 方法在这两个类中都可以使用。
• 在此示例中，我们使用 DateTime 类进行演示，但 DateTimeImmutable 类也具有相同的 format() 方法用法。