0

0

Python datetime 如何正确解析带 Z 或 +08:00 的 ISO 格式

舞姬之光

舞姬之光

发布时间:2026-01-23 20:11:02

|

375人浏览过

|

来源于php中文网

原创

datetime.fromisoformat() 不支持 z 后缀和带冒号时区(如+08:00),python 3.11+ 支持 z 但仍不支持冒号;推荐用 dateutil.parser.parse() 或预处理后配合 strptime() 解析。

python datetime 如何正确解析带 z 或 +08:00 的 iso 格式

datetime.fromisoformat() 无法解析带 Z 的字符串

datetime.fromisoformat() 是 Python 3.7+ 提供的便捷方法,但它**不支持 Z 后缀或带冒号的时区偏移(如 +08:00)**。直接调用会抛出 ValueError: Invalid isoformat string

这是最常踩的坑:以为 ISO 就是 fromisoformat() 的全部覆盖范围,其实它只支持「简化 ISO 8601」——即不含 Z、不含冒号分隔的时区(如 +0800 才勉强可解析,+08:00 不行)。

实操建议:

  • 若输入确定为标准 ISO 格式(含 Z+08:00),别用 fromisoformat(),改用 datetime.fromisoformat() 的替代方案
  • 可先预处理字符串:把 Z 替换为 +00:00,再统一用 datetime.strptime() 或第三方库解析
  • Python 3.11+ 的 fromisoformat() 已支持 Z,但依然不支持 +08:00 中的冒号 —— 所以兼容性仍受限

用 strptime() 解析 Z 和 +08:00 的正确写法

datetime.strptime() 灵活但需手动指定格式,关键在时区部分的匹配:

立即学习Python免费学习笔记(深入)”;

Kacha
Kacha

KaCha是一款革命性的AI写真工具,用AI技术将照片变成杰作!

下载
  • Z 对应 %z,但 %z **不接受字面量 Z**,只接受 +0000 形式;所以得先替换:s.replace('Z', '+0000')
  • +08:00 中的冒号无法被 %z 直接识别(%z 要求 +0800),需先去掉冒号:re.sub(r'([+-]\d{2}):(\d{2})', r'\1\2', s)
  • 完整解析示例:
    from datetime import datetime
    import re
    
    s = "2023-04-05T12:30:45.123Z"
    s_clean = s.replace('Z', '+0000')
    dt = datetime.strptime(s_clean, '%Y-%m-%dT%H:%M:%S.%f%z')
    
    s2 = "2023-04-05T12:30:45.123+08:00"
    s2_clean = re.sub(r'([+-]\d{2}):(\d{2})', r'\1\2', s2)
    dt2 = datetime.strptime(s2_clean, '%Y-%m-%dT%H:%M:%S.%f%z')

    注意:%f 只匹配 6 位微秒,若输入毫秒(3 位)或更长,strptime 会失败 —— 建议用正则先截断或补零

    推荐用 dateutil.parser.parse() 处理真实场景

    绝大多数实际项目中,输入格式不可控(Z+08:00+0800、甚至无时区),硬写 strptime 易出错且维护成本高。dateutil.parser.parse() 是更鲁棒的选择:

    • 自动识别 Z+08:00-05:30 等所有常见 ISO 变体
    • 默认返回 tzinfo 完整的 datetime 对象(不是 naive 时间)
    • 安装:pip install python-dateutil
    • 用法极简:from dateutil import parser; dt = parser.parse("2023-04-05T12:30:45.123+08:00")
    • 性能略低于 strptime,但对非高频解析场景无感;若需极致性能,再考虑缓存或预编译

    时区感知 vs. naive 时间:容易忽略的关键点

    无论用哪种方式解析,结果是否带 tzinfo 决定了后续操作是否安全:

    • strptime(...%z)dateutil.parser.parse() 得到的是 aware datetime(含时区),可直接比较、转换、转 UTC
    • 误用 fromisoformat() 解析成功(比如输入恰巧是 +0800)但没注意它返回的是 aware 对象,而你代码里又混用了 naive 时间,会导致 TypeError: can't compare offset-naive and offset-aware datetimes
    • 如果业务只要本地时间且不涉及时区转换,可显式转 naive:dt.replace(tzinfo=None),但务必确认这是有意为之,而非疏忽

    真正复杂的地方不在解析语法,而在后续所有时间运算都依赖这个 aware/naive 判断 —— 一个没注意,就可能在跨时区服务里埋下数据偏差隐患

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

373

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

436

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

802

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

370

2025.07.23

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1010

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号