Python time strptime()方法（长文讲解）

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

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

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

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

在编程的世界中，时间处理是一个既基础又复杂的领域。无论是记录日志、分析数据，还是构建需要时间戳的应用程序，开发者常常需要将字符串形式的时间信息转换为程序可以处理的结构化对象。Python 的 time 模块中的 strptime() 方法，正是实现这一目标的核心工具之一。本文将从零开始，逐步解析 strptime() 方法的功能、使用技巧和常见问题，并通过实际案例帮助读者掌握这一重要技能。

一、什么是 strptime() 方法？

strptime() 是 Python 标准库 time 模块中的一个方法，其名称来源于 "string parse time" 的缩写。它的核心作用是将一个符合特定格式的字符串，解析为一个 struct_time 对象，从而让开发者能够方便地对时间进行计算、比较或格式化。

简单比喻：
可以将 strptime() 想象为一位“翻译官”，它将人类可读的时间字符串（如 "2023-10-01 15:30:00"）翻译成计算机可处理的“时间代码”（struct_time 对象），而 strftime() 则是它的逆过程，负责将“时间代码”翻译回字符串。

二、strptime() 的基础用法

1. 语法与参数

strptime() 的基本语法如下：

time.strptime(string, format)  

其中：

• string 是需要解析的原始时间字符串。
• format 是定义字符串格式的模板，使用特定的格式代码（如 %Y 表示年份）。

2. 第一个示例

import time  

time_str = "2023-10-01 15:30:00"  

parsed_time = time.strptime(time_str, "%Y-%m-%d %H:%M:%S")  

print(parsed_time)  

关键点说明：

• 格式字符串中的 %Y 表示四位数的年份（如 2023），而 %y 表示两位数的年份（如 23）。
• %m 表示月份（01 至 12），而 %d 表示日期（01 至 31）。
• %H 是 24 小时制的小时（00 至 23），而 %I 是 12 小时制的小时。

三、格式代码详解：理解 strptime() 的“密码”

strptime() 的功能完全依赖于格式字符串中的代码组合。以下表格列出了最常用的格式代码及其含义：

示例解析：
假设时间字符串为 "Sun Oct 01 15:30:00 2023"，对应的格式字符串应为 "%a %b %d %H:%M:%S %Y"。

四、常见问题与解决方案

1. 格式字符串与时间字符串不匹配

如果提供的格式字符串与实际时间字符串不一致，strptime() 会抛出 ValueError。例如：

time_str = "2023-10-01 15:30:00"  
time.strptime(time_str, "%Y-%m-%d %H:%M")  

解决方案：
确保格式字符串中的每个部分都与输入字符串严格匹配。

2. 处理时区信息

strptime() 默认不处理时区，因此如果时间字符串包含时区（如 +0800），需要手动处理或使用第三方库（如 pytz）。

time_str = "2023-10-01 15:30:00+08:00"  
parsed_time = time.strptime(time_str[:19], "%Y-%m-%d %H:%M:%S")  

3. 处理包含文字描述的字符串

如果时间字符串包含非数字字符（如 "October 1st, 2023"），需使用对应的格式代码（如 %B 和 %d）。

time_str = "October 1st, 2023"  
parsed_time = time.strptime(time_str, "%B %dst, %Y")  

五、实际案例：解析日志文件的时间戳

假设我们有一个日志文件，其时间戳格式为 "Oct 01 15:30:00 2023"，我们需要将其转换为 struct_time 对象以便后续分析：

import time  

log_entry = "Oct 01 15:30:00 2023"  

format_str = "%b %d %H:%M:%S %Y"  

try:  
    parsed_time = time.strptime(log_entry, format_str)  
    print("解析成功！")  
    print(parsed_time)  
except ValueError as e:  
    print(f"解析失败：{e}")  

输出结果：

解析成功！  
time.struct_time(tm_year=2023, tm_mon=10, tm_mday=1, tm_hour=15, tm_min=30, tm_sec=0, tm_wday=6, tm_yday=274, tm_isdst=-1)  

六、进阶技巧：结合 datetime 模块

虽然 strptime() 属于 time 模块，但实际开发中更推荐使用 datetime 模块的 datetime.strptime()，因为它提供了更丰富的功能和更直观的对象模型。

from datetime import datetime  

time_str = "2023-10-01T15:30:00"  
dt_object = datetime.strptime(time_str, "%Y-%m-%dT%H:%M:%S")  

print(dt_object)  # 输出：2023-10-01 15:30:00  

结论

Python time strptime()方法 是时间处理领域的核心工具，它通过灵活的格式字符串，将文本时间转换为结构化对象。掌握其用法不仅能提升代码的健壮性，还能为数据分析、日志处理等场景提供强大支持。

关键回顾：

1. 格式字符串是 strptime() 的灵魂，需与输入字符串精确匹配。
2. 常见问题多源于格式代码的误用或缺失，需通过调试逐步排查。
3. 结合 datetime 模块可进一步扩展时间处理的功能边界。

希望本文能帮助开发者快速上手 strptime()，并在实际项目中灵活运用这一方法。