如何解决 DeprecationWarning: datetime.datetime.utcnow() is deprecated and scheduled for removal in a fut

如何解决 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共创团队 🌐

加入猫头虎的共创圈,一起探索编程世界的无限可能! 🚀

部分专栏链接

🔗 精选专栏


猫头虎分享No bug

正文


问题复现

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
  • 保证单一代码在多个版本中行为一致。

迁移与测试建议

  1. 批量替换
    使用 IDE 或命令行工具(grepsed)将所有 datetime.utcnow() 替换为兼容写法。

  2. CI 强化

    • 在 CI 中切换到 Python 3.12。
    • 使用 -W error 标志将所有警告视为错误,确保无遗漏。
  3. 代码审查
    检查项目中是否存在 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共创社群矩阵。一起探索科技的未来,共同成长。🚀

评论 15
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

猫头虎

一分也是爱,打赏博主成就未来!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值