如何解决 DeprecationWarning: datetime.datetime.utcnow() is deprecated and scheduled for removal in a future version. Use timezone-aware objects to represent datetimes in UTC: datetime.datetime.now(datetime.UTC)
问题
引言
在 Python 3.12 中,datetime.datetime.utcnow()
将被弃用,推荐使用时区感知(timezone-aware)的 datetime.datetime.now(datetime.UTC)
来获取 UTC 时间。这一改变能够避免“天真”(naive)datetime
对象引发的时区歧义,提高代码的可维护性和健壮性。
文章目录
作者简介
猫头虎是谁?
大家好,我是 猫头虎,猫头虎技术团队创始人,也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人,以及云原生开发者社区主理人,在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。
我的博客内容涵盖广泛,主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验,以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。
目前,我活跃在CSDN、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台,全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。
我希望通过我的分享,帮助大家更好地掌握和使用各种技术产品,提升开发效率与体验。
作者名片 ✍️
- 博主:猫头虎
- 全网搜索关键词:猫头虎
- 作者微信号:Libin9iOak
- 作者公众号:猫头虎技术团队
- 更新日期:2025年05月02日
- 🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能!
加入我们AI共创团队 🌐
- 猫头虎AI共创社群矩阵列表:
加入猫头虎的共创圈,一起探索编程世界的无限可能! 🚀
部分专栏链接
:
🔗 精选专栏:
- 《面试题大全》 — 面试准备的宝典!
- 《IDEA开发秘籍》 — 提升你的IDEA技能!
- 《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师!
- 《100天精通Golang(基础入门篇)》 — 踏入Go语言世界的第一步!
正文
问题复现
from datetime import datetime
now = datetime.utcnow().isoformat()
print(now)
在 Python 3.12 环境下会看到警告:
DeprecationWarning: datetime.datetime.utcnow() is deprecated and scheduled for removal in a future version.
Use timezone-aware objects to represent datetimes in UTC: datetime.datetime.now(datetime.UTC).
now = datetime.utcnow().isoformat()
为什么要弃用 utcnow()
-
Naive vs. Aware
- Naive datetime:不包含时区信息,无法区分本地时间与 UTC,容易在跨时区环境中出错。
- Aware datetime:带有
tzinfo
,明确表示所处时区,便于安全转换和比较。
-
一致性与明确性
使用时区感知的 API 可避免开发者误将 UTC 时间当成本地时间处理,减少潜在 bug。
解决方案
1. 最通用的写法(Python 3.1+)
from datetime import datetime, timezone
now = datetime.now(timezone.utc).isoformat()
print(now)
# 示例输出:2025-05-06T14:23:45.123456+00:00
timezone.utc
是内置的 UTC 时区对象。- 生成的 ISO 8601 字符串中包含
+00:00
时区偏移。
2. 使用 datetime.UTC
(Python 3.11+)
from datetime import datetime
now = datetime.now(datetime.UTC).isoformat()
print(now)
# 示例输出:2025-05-06T14:23:45.123456+00:00
datetime.UTC
是从 Python 3.11 新增的 UTC 常量,等同于timezone.utc
。- 需要确保运行时版本 ≥ 3.11。
3. 多版本兼容写法
from datetime import datetime, timezone
try:
UTC = datetime.UTC
except AttributeError:
UTC = timezone.utc
now = datetime.now(UTC).isoformat()
print(now)
- Python ❤️.11 时使用
timezone.utc
,≥3.11 时使用datetime.UTC
。 - 保证单一代码在多个版本中行为一致。
迁移与测试建议
-
批量替换
使用 IDE 或命令行工具(grep
、sed
)将所有datetime.utcnow()
替换为兼容写法。 -
CI 强化
- 在 CI 中切换到 Python 3.12。
- 使用
-W error
标志将所有警告视为错误,确保无遗漏。
-
代码审查
检查项目中是否存在utcfromtimestamp()
、fromtimestamp()
(未传入tz
参数)等生成 naive datetime 的调用,统一改为传入时区。
最佳实践
- 始终使用时区感知的 datetime:无论是日志记录、数据存储还是 API 通信,都应附带
tzinfo
。 - 统一格式:推荐使用 ISO 8601(
.isoformat()
),并保留时区偏移。 - 完善文档:在团队文档或代码注释中说明为什么要使用 timezone-aware,对新成员非常友好。
总结
Python 3.12 弃用了 datetime.utcnow()
,这是朝着更安全、明确的时区处理方式迈进的一步。通过改用 datetime.now(timezone.utc)
或 datetime.now(datetime.UTC)
,你可以:
- 避免时区歧义
- 提升代码兼容性
- 防止未来版本中因弃用带来的运行错误
赶快在你的项目中进行全面迁移吧!
粉丝福利
👉 更多信息:有任何疑问或者需要进一步探讨的内容,欢迎点击文末名片获取更多信息。我是猫头虎博主,期待与您的交流! 🦉💬
联系我与版权声明 📩
- 联系方式:
- 微信: Libin9iOak
- 公众号: 猫头虎技术团队
- 版权声明:
本文为原创文章,版权归作者所有。未经许可,禁止转载。更多内容请访问猫头虎的博客首页。
点击✨⬇️下方名片
⬇️✨,加入猫头虎AI共创社群矩阵。一起探索科技的未来,共同成长。🚀