本文详解如何正确使用strptime解析形如2025-03-12T23:00:00.000Z的ISO 8601 UTC时间字符串，重点指出%Z不能用于解析字面量Z，而应直接写入格式串，并说明替代方案（如fromisoformat）以提升健壮性。

本文详解如何正确使用strptime解析形如2025-03-12t23:00:00.000z的iso 8601 utc时间字符串，重点指出%z不能用于解析字面量z，而应直接写入格式串，并说明替代方案（如fromisoformat）以提升健壮性。

在Python中，使用datetime.strptime()解析ISO 8601格式的UTC时间字符串（例如 "2025-03-12T23:00:00.000Z"）时，常见的错误是误用%Z作为Z（代表零时区）的占位符。实际上，%Z用于匹配时区名称（如 "UTC"、"PST"），而非字面量"Z"；而Z本身是ISO 8601标准中表示UTC偏移量 +00:00 的固定字符，需在格式字符串中原样写出，不加%前缀。

因此，原始代码：

time_utc = datetime.strptime(utc_string, '%Y-%m-%dT%H:%M:%S.%f%Z').replace(tzinfo=timezone.utc)

会抛出 ValueError: time data '2025-03-12T23:00:00.000Z' does not match format '%Y-%m-%dT%H:%M:%S.%f%Z'，因为%Z试图匹配一个时区名，但输入中只有单个字母Z。

✅ 正确写法是将%Z改为字面量Z：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

from datetime import datetime, timezone

utc_string = "2025-03-12T23:00:00.000Z"
time_utc = datetime.strptime(utc_string, '%Y-%m-%dT%H:%M:%S.%fZ').replace(tzinfo=timezone.utc)
print(time_utc)  # 2025-03-12 23:00:00+00:00

⚠️ 注意事项：

• .000 表示毫秒，对应 %f（微秒占位符），它会自动补零至6位（即 .000 → 000000 微秒），因此该格式可兼容 .000、.123 甚至 .123456。
• 若字符串可能含毫秒以外精度（如纳秒），或存在空格/换行等干扰，strptime 易失败；推荐更鲁棒的替代方案：

  # Python 3.7+ 推荐：直接解析ISO格式（自动识别Z）
  time_utc = datetime.fromisoformat(utc_string.replace('Z', '+00:00'))
  # 或更简洁（3.11+ 支持Z直接解析）：
  # time_utc = datetime.fromisoformat(utc_string)  # ✅ 3.11+

? 总结：

• Z 是字面量，不是格式码 → 格式串中写 Z，而非 %Z；
• %Z 仅匹配时区缩写（如 "UTC"），且依赖系统locale，不可靠；
• 对于标准ISO 8601字符串，优先使用 datetime.fromisoformat()（Python ≥3.7），它原生支持 Z，语义清晰、容错更强；
• 若需兼容旧版本或自定义逻辑，确保格式字符串严格匹配输入结构，并显式绑定 timezone.utc。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！