PHP strptime() 函数（一文讲透）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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 strptime() 函数正是这样一个功能强大的工具，它能够将符合特定格式的日期字符串解析为结构化的数组，帮助开发者快速提取和操作时间信息。

本文将从基础语法到实际应用，逐步解析 PHP strptime() 函数的核心原理和使用技巧，并通过代码示例和对比分析，帮助读者掌握这一函数的精髓。

一、基础语法解析

1.1 函数定义与基本用法

strptime() 函数的作用是将日期时间字符串解析为结构化的数组。其语法格式如下：

array strptime ( string $datetime , string $format )  

• 参数说明：

  • $datetime：需要解析的日期时间字符串。
  • $format：定义 $datetime 的格式模板，使用特定的格式代码（如 %Y 表示四位年份）。

• 返回值：
  成功时返回一个关联数组，包含解析后的各个时间部分（如年、月、日、时等）；失败时返回 false。

1.2 格式代码详解

strptime() 的核心在于 format 参数的格式代码。常见的格式代码包括：

示例代码：

$result = strptime('2023-10-05 15:30:00', '%Y-%m-%d %H:%M:%S');  
print_r($result);  

// 输出结果：  
// Array (  
//     [tm_sec] => 0  
//     [tm_min] => 30  
//     [tm_hour] => 15  
//     [tm_mday] => 5  
//     [tm_mon] => 9  
//     [tm_year] => 123  
//     [tm_wday] => 4  
//     [tm_yday] => 277  
//     [tm_isdst] => 0  
// )  

二、参数详解与进阶用法

2.1 格式模板的灵活性

strptime() 的强大之处在于其格式模板的高度灵活性。开发者可以根据实际需求自定义模板，例如：

• 日期与时间的混合格式：

  $datetime = "2023年10月5日 下午3:30";  
  $format = "%Y年%m月%d日 %p%I:%M"; // %p 表示上午/下午，%I 表示12小时制  
  $result = strptime($datetime, $format);  
  

• 处理带时区的日期字符串：

  $datetime = "2023-10-05T15:30:00+08:00";  
  $format = "%Y-%m-%dT%H:%M:%S%z"; // %z 解析时区偏移  
  $result = strptime($datetime, $format);  
  

2.2 格式代码的扩展与注意事项

除了基础格式代码外，还有一些特殊代码需要注意：

• %a：缩写星期名（如 Mon）
• %b：缩写月份名（如 Oct）
• %A：全称星期名（如 Monday）
• %B：全称月份名（如 October）
• %p：上午/下午标记（AM/PM）

注意事项：

• 格式代码必须与输入字符串的格式严格匹配，否则返回 false。
• 月份和星期的名称（如 %b、%B）会受本地化设置影响，建议优先使用数字格式（如 %m）。

三、与 strtotime() 的对比分析

3.1 核心区别

strptime() 和 strtotime() 常被混淆，但两者用途不同：

• strptime()：

  • 功能：将符合特定格式的字符串解析为数组。
  • 适用场景：处理结构化严格的日期时间格式（如日志文件、固定格式的用户输入）。
  • 示例：解析 "2023-10-05" 为年、月、日字段。

• strtotime()：

  • 功能：将自然语言描述的日期时间（如 "明天下午3点"）转换为 Unix 时间戳。
  • 适用场景：处理模糊或自然语言的时间表达。
  • 示例：解析 "next Friday" 为时间戳。

3.2 实际应用对比

四、实际案例与代码示例

4.1 案例1：解析日志文件的时间戳

假设日志文件的格式为 "2023-10-05T15:30:00"，需要提取年、月、日、时、分、秒：

$log_entry = "2023-10-05T15:30:00";  
$format = "%Y-%m-%dT%H:%M:%S";  
$parsed = strptime($log_entry, $format);  

if ($parsed !== false) {  
    echo "Year: " . ($parsed['tm_year'] + 1900) . "<br>"; // tm_year 返回年份减去1900  
    echo "Month: " . ($parsed['tm_mon'] + 1) . "<br>";     // tm_mon 返回0-11  
    echo "Day: " . $parsed['tm_mday'] . "<br>";  
    echo "Hour: " . $parsed['tm_hour'] . "<br>";  
}  

4.2 案例2：验证用户输入的日期格式

用户提交的日期格式应为 "YYYY-MM-DD"，需验证并提取年月日：

$user_input = "2023-10-32"; // 错误日期  
$format = "%Y-%m-%d";  

if (strptime($user_input, $format) === false) {  
    echo "日期格式错误！";  
} else {  
    echo "日期有效！";  
}  

4.3 案例3：处理带缩写月份的字符串

输入为 "Oct 5, 2023"，需解析为数值格式：

$date_str = "Oct 5, 2023";  
$format = "%b %d, %Y";  
$parsed = strptime($date_str, $format);  

if ($parsed) {  
    echo "Month: " . $parsed['tm_mon'] + 1; // 输出 10  
}  

五、常见问题与解决方案

5.1 为什么返回 false？

• 原因：输入字符串的格式与 format 不匹配。
• 解决方案：
  1. 检查格式代码是否正确（如 %m 对应月份，而非 %M）。
  2. 确保输入字符串不含多余字符（如空格或特殊符号）。

5.2 如何获取完整的年份（四位数）？

strptime() 返回的 tm_year 字段是年份减去 1900 的结果。例如，2023 年会返回 123。因此，需手动计算：

$year = $parsed['tm_year'] + 1900;  

5.3 如何处理不同地区的日期格式？

例如，美国格式 "10/5/2023" 和欧洲格式 "5/10/2023"：

// 美国格式（月/日/年）  
strptime("10/5/2023", "%m/%d/%Y");  

// 欧洲格式（日/月/年）  
strptime("5/10/2023", "%d/%m/%Y");  

六、总结与扩展

通过本文的学习，开发者可以掌握 PHP strptime() 函数的核心用法和进阶技巧。该函数在以下场景中尤为实用：

• 固定格式解析：如日志文件、CSV 文件中的日期字段。
• 用户输入验证：确保输入的日期符合预定义格式。
• 时间数据拆分：将字符串分解为年、月、日等独立字段。

若需进一步优化时间处理，可结合 DateTime 类或 date_create_from_format() 函数，实现更复杂的操作。例如：

$datetime = DateTime::createFromFormat('Y-m-d H:i:s', '2023-10-05 15:30:00');  
echo $datetime->format('Y-m-d'); // 输出 2023-10-05  

总之，strptime() 是 PHP 开发者工具箱中不可或缺的利器，掌握其用法能显著提升日期时间处理的效率和准确性。