PHP date_format() 函数（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，日期和时间的处理是一个高频需求。无论是记录用户注册时间、展示文章发布时间，还是计算业务周期，开发者都需要灵活控制日期的显示格式。而 PHP date_format() 函数正是实现这一目标的核心工具之一。它通过简单的语法和丰富的格式参数，让开发者能够轻松将日期对象转换为任意自定义的字符串格式。本文将从基础用法到高级技巧，结合案例与代码示例，帮助读者全面掌握这一函数。

一、基础用法：date_format() 函数的语法与参数

函数语法

date_format() 函数的基本语法如下：

string date_format(DateTime $object, string $format)  

• $object：一个由 date_create() 或 DateTime 类实例化的日期对象。
• $format：定义输出日期格式的字符串，由一系列预定义的格式字符构成（后文会详细讲解）。

示例：输出当前日期

以下代码演示如何获取当前日期并格式化为“YYYY-MM-DD”格式：

// 创建当前时间的 DateTime 对象  
$current_date = date_create();  

// 使用 date_format() 格式化日期  
$formatted_date = date_format($current_date, 'Y-m-d');  

echo $formatted_date; // 输出类似：2023-10-15  

关键点解析：

1. date_create() 会返回一个包含当前时间的 DateTime 对象。
2. date_format() 的第二个参数 'Y-m-d' 定义了输出格式，其中 Y 表示四位年份，m 表示两位月份，d 表示两位日期。

二、格式化参数详解：构建日期字符串的“积木”

核心格式字符表

以下表格列出了 date_format() 中最常用的格式字符及其含义：

比喻说明：
可以将这些格式字符视为“乐高积木”，通过组合不同的字符，开发者可以像拼装积木一样构建出所需的日期格式。例如，Y-m-d H:i:s 将拼出“2023-10-15 14:30:45”这样的完整时间戳。

组合格式字符的技巧

1. 直接拼接字符：

   // 输出格式：2023年10月15日 下午02:30  
   $formatted_date = date_format($current_date, 'Y年n月j日 g:i A');  
   

   这里 g 表示 12 小时制的无前导零小时，A 则显示大写的 AM/PM。

2. 添加文本分隔符：

   // 输出：2023-10-15 14:30:45 UTC  
   $formatted_date = date_format($current_date, 'Y-m-d H:i:s T');  
   

   其中 T 代表时区缩写（如 UTC、EST 等）。

三、常见问题与解决方案

1. 处理时区问题

默认情况下，date_create() 返回的日期对象使用服务器的本地时区。若需指定其他时区，可通过 DateTimeZone 类实现：

// 设置时区为 UTC  
$timezone = new DateTimeZone('UTC');  
$current_date = date_create(null, $timezone);  

2. 处理无效日期

如果传入的日期无效（如“2023-02-30”），date_format() 可能返回错误。可通过 date_validatable() 或 DateTime::getLastErrors() 检查合法性：

$date = date_create('2023-02-30');  
$errors = date_get_last_errors();  
if ($errors['warning_count'] > 0) {  
    echo '无效日期';  
}  

3. 与 date() 函数的区别

date() 函数可以直接格式化当前时间，而 date_format() 需要一个 DateTime 对象。例如：

// 使用 date() 的方式  
echo date('Y-m-d'); // 输出当前日期  

但 date_format() 在处理复杂日期操作（如跨时区计算）时更具灵活性。

四、高级技巧：date_format() 的进阶用法

1. 结合 strtotime() 处理相对时间

通过 strtotime() 可以将自然语言转换为时间戳，再传递给 date_create()：

// 输出“三天前”的日期  
$three_days_ago = strtotime('-3 days');  
$date = date_create('@' . $three_days_ago);  
echo date_format($date, 'Y-m-d'); // 如：2023-10-12  

2. 格式化国际化日期

若需适配不同地区的日期格式（如“日-月-年”），可直接调整格式字符串：

// 输出：15/10/2023  
echo date_format($current_date, 'd/m/Y');  

3. 格式化时间间隔

通过 date_diff() 和 date_format() 结合，可计算并显示时间差：

$date1 = date_create('2023-10-15');  
$date2 = date_create('2023-10-20');  
$interval = date_diff($date1, $date2);  
echo $interval->format('%a 天'); // 输出：5 天  

五、实战案例：date_format() 的应用场景

案例 1：生成文章发布时间

// 假设文章发布于 2023-10-15 14:30  
$post_date = date_create('2023-10-15 14:30:00');  
$formatted_time = date_format($post_date, 'Y年m月d日 H:i');  
echo '发布于：' . $formatted_time; // 输出：发布于 2023年10月15日 14:30  

案例 2：计算剩余时间

// 假设活动截止日期为 2023-10-20  
$end_date = date_create('2023-10-20');  
$remaining = date_diff(date_create(), $end_date);  
echo $remaining->format('剩余 %d 天'); // 根据当前时间动态显示  

案例 3：国际化日期格式

// 根据用户语言切换格式  
$locale = 'zh-CN'; // 假设用户选择中文  
switch ($locale) {  
    case 'zh-CN':  
        $format = 'Y年m月d日';  
        break;  
    case 'en-US':  
        $format = 'F d, Y'; // 如 October 15, 2023  
        break;  
}  
echo date_format($current_date, $format);  

结论

PHP date_format() 函数凭借其简洁的语法和强大的格式化能力，成为处理日期输出的首选工具。通过掌握格式字符的组合规则、时区管理技巧以及与相关函数的协作，开发者可以高效地满足各类日期显示需求。无论是基础的日期展示，还是复杂的国际化适配，date_format() 都能提供灵活且可靠的解决方案。建议读者在实际项目中多加实践，并结合 DateTime 类的其他方法（如 modify()、setDate()）进一步扩展功能。

记住：日期格式化不仅是技术问题，更是用户体验的细节体现——一个清晰、友好的日期显示，往往能提升用户对产品的整体好感。