本文详解 datetime.strptime() 常见报错原因及完整用法，重点解决因缺少模块导入、格式码不匹配或输入异常导致的解析失败问题，并提供可直接运行的示例代码与实用调试建议。
本文详解 `datetime.strptime()` 常见报错原因及完整用法，重点解决因缺少模块导入、格式码不匹配或输入异常导致的解析失败问题，并提供可直接运行的示例代码与实用调试建议。
在 Python 中，datetime.strptime() 是将字符串安全转换为 datetime 对象的核心方法。但初学者常遇到 NameError: name 'datetime' is not defined 或 ValueError: time data ... does not match format ... 等错误——这些并非函数本身缺陷，而是调用前提或格式定义未满足所致。
✅ 正确用法：三要素缺一不可
- 显式导入：必须从 datetime 模块导入 datetime 类（注意：模块名与类名相同，易混淆）；
- 严格匹配格式码：字符串内容必须与 strptime 的格式字符串（如 "%Y-%m-%d %H:%M:%S"）完全一致；
- 输入合法：年份、月份、小时等值需在有效范围内（如月份不能为 13，小时不能为 25）。
以下是最小可运行示例：
from datetime import datetime date_str = "2024-04-19 15:30:00" datetime_obj = datetime.strptime(date_str, "%Y-%m-%d %H:%M:%S") print(datetime_obj) # 输出：2024-04-19 15:30:00
⚠️ 常见错误及修复方案：
NameError: name 'datetime' is not defined
→ 未导入或导入方式错误。❌ 错误写法：import datetime 后直接调用 datetime.strptime(...)（此时 datetime 指模块，无 strptime 方法）。✅ 正确写法：from datetime import datetime，或 import datetime 后用 datetime.datetime.strptime(...)。ValueError: time data '2024-04-19 15:30' does not match format '%Y-%m-%d %H:%M:%S'
→ 格式码中要求秒（%S），但字符串缺失。修复：改为 "%Y-%m-%d %H:%M"，或补全字符串为 "2024-04-19 15:30:00"。ValueError: unconverted data remains
→ 字符串含多余字符（如末尾空格、时区标识 +0800）。建议先 strip()，或使用更健壮的库（如 dateutil.parser）处理模糊格式。
? 调试技巧
- 使用 datetime.strftime() 反向验证：对已知 datetime 对象调用 .strftime(fmt)，对比输出是否与原始字符串一致；
- 利用 Python 官方格式码文档 核对每个占位符含义（例如 %y 是两位年份，%Y 是四位）；
- 对不确定格式的字符串，优先考虑 dateutil.parser.parse()（需 pip install python-dateutil），它能自动推断多数常见格式。
掌握 strptime 的关键是“精确匹配”——它不是智能解析器，而是严格按模板校验。确保导入正确、格式精准、数据合规，即可零错误完成字符串到时间对象的转换。
