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

最新推荐文章于 2025-05-28 17:29:54 发布

猫头虎

最新推荐文章于 2025-05-28 17:29:54 发布

阅读量1.5w

点赞数 21

文章标签： pycharm python django httpx pip python3.11 ipython

转载必须标明来源：猫头虎技术团队，其他疑问搜： CSDNWF

本文链接：https://blog.csdn.net/qq_44866828/article/details/147732802

版权

已解决的Bug专区专栏收录该内容

219 篇文章

订阅专栏

如何解决 `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 对象引发的时区歧义，提高代码的可维护性和健壮性。

在这里插入图片描述

文章目录

如何解决 `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)` 问题
- 引言
作者简介
正文
粉丝福利
- - 联系我与版权声明 📩

作者简介

猫头虎是谁？

大家好，我是猫头虎，猫头虎技术团队创始人，也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人，以及云原生开发者社区主理人，在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验，以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。

目前，我活跃在CSDN、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台，全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。

我希望通过我的分享，帮助大家更好地掌握和使用各种技术产品，提升开发效率与体验。

作者名片 ✍️

博主：猫头虎
全网搜索关键词：猫头虎
作者微信号：Libin9iOak
作者公众号：猫头虎技术团队
更新日期：2025年05月02日
🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！

加入我们AI共创团队 🌐

猫头虎AI共创社群矩阵列表：
- 点我进入共创社群矩阵入口
- 点我进入新矩阵备用链接入口

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

部分专栏链接：

🔗 精选专栏：

《面试题大全》 — 面试准备的宝典！
《IDEA开发秘籍》 — 提升你的IDEA技能！
《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师！
《100天精通Golang（基础入门篇）》 — 踏入Go语言世界的第一步！

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

迁移与测试建议

批量替换
使用 IDE 或命令行工具（grep、sed）将所有 datetime.utcnow() 替换为兼容写法。
CI 强化
- 在 CI 中切换到 Python 3.12。
- 使用 -W error 标志将所有警告视为错误，确保无遗漏。
代码审查
检查项目中是否存在 utcfromtimestamp()、fromtimestamp()（未传入 tz 参数）等生成 naive datetime 的调用，统一改为传入时区。