如何使用 date_format 格式化 PHP 中的日期时间对象

---

在日常的 PHP 开发中，我们经常需要对日期和时间进行格式化处理，比如将数据库中的时间戳转换为“年-月-日”这样的格式，或者只显示具体的小时和分钟信息。PHP 中的 date_format() 函数就是专门为此设计的工具之一，它可以帮助我们快速地以自定义的格式输出日期时间。

一、什么是 date_format 函数？

date_format() 是 PHP 中的一个内置函数，用于将一个 DateTime 对象格式化为指定的日期字符串。

函数的基本语法如下：

<code> date_format(DateTime $object, string $format): string </code>

• $object：一个 DateTime 类型的对象。

• $format：要输出的时间格式，格式规则与 date() 函数一致。

二、常见格式字符说明

以下是一些常用的格式化字符：

三、基础使用示例

我们先来看一个最基本的例子，将当前时间格式化为“年-月-日 小时:分钟:秒”：

<code> $now = new DateTime(); echo date_format($now, 'Y-m-d H:i:s'); </code>

输出示例：

2025-06-03 14:08:55

四、结合数据库日期使用

假设你从数据库中取出了一个时间字符串 '2025-06-03 09:30:00'，你想将其格式化为 03/06/2025 的格式：

<code> $dateString = '2025-06-03 09:30:00'; $dateObj = date_create($dateString); echo date_format($dateObj, 'd/m/Y'); </code>

输出为：

03/06/2025

五、自定义输出：只显示时间

有时候你只需要输出时间部分，比如“09:30 AM”：

<code> $date = date_create('2025-06-03 09:30:00'); echo date_format($date, 'h:i A'); </code>

输出：

09:30 AM

六、实战技巧：显示中文格式日期

要以中文方式输出，比如“2025年6月3日”，可以这样写：

<code> $date = new DateTime(); echo date_format($date, 'Y年n月j日'); </code>

输出：

2025年6月3日

七、处理用户自定义输入时间

如果你接收到用户传入的日期字符串，也可以用 date_format() 进行处理。例如用户提交了一个表单，输入了 2025-12-01：

<code> $userInput = '2025-12-01'; $date = date_create($userInput); echo date_format($date, 'l, F jS, Y'); </code>

输出为：

Monday, December 1st, 2025

八、结合应用示例：事件提醒功能

假设你在开发一个提醒应用，希望显示“活动将在 2025年6月3日 上午9:00 举行”，你可以这么做：

<code> $eventTime = date_create('2025-06-03 09:00:00'); echo '活动将在 ' . date_format($eventTime, 'Y年n月j日 A g:i') . ' 举行'; </code>

注意其中 A 表示“AM/PM”，g 是不带前导零的小时。

九、在项目中的应用场景

• 文章发布时间展示

• 用户注册时间记录

• 日历模块中的日期格式输出

• 导出报表中的时间戳格式化

这些地方都能看到 date_format() 的身影，是开发者非常值得掌握的函数之一。

十、小结

date_format() 是一个简单而强大的工具，它结合 DateTime 对象使用，可以实现灵活多变的日期时间格式化输出。与其死记硬背各种格式，不如动手实践几次，自然就会了！

如果你正在开发某个项目，比如在 gitbox.net 上搭建的系统，这个函数同样能帮助你处理各种日期展示需求，提高代码的可读性与专业度。

掌握 date_format()，让你的时间输出更清晰、更贴心！