0

0

Python 使用 timezone 的正确姿势

冷漠man

冷漠man

发布时间:2026-02-18 16:37:14

|

131人浏览过

|

来源于php中文网

原创

datetime.now() 不带时区是错误的,必须用 datetime.now(timezone.utc) 或 datetime.now(zoneinfo("asia/shanghai"));timezone.utc 是常量不可调用;zoneinfo 比 pytz 更可靠;存数据库应优先存 utc 时间。

python 使用 timezone 的正确姿势

datetime.now() 不带 timezone 就是错的

Python 的 datetime.now() 默认返回「本地时间但无时区信息」,也就是 tzinfo=None。这种对象在跨时区、存数据库、和 API 交互时会出问题——比如你在北京生成的时间,传到服务器(UTC)后可能被当成 UTC 时间直接解析,结果差 8 小时。

正确做法是:只要涉及时间比较、序列化、持久化,就必须用带 tzinfodatetime

  • 别写 datetime.now(),改用 datetime.now(timezone.utc)(获取 UTC 时间)或 datetime.now(ZoneInfo("Asia/Shanghai"))(需 Python 3.9+)
  • 旧项目还在用 pytz?注意 pytz.timezone("Asia/Shanghai").localize(dt) 才安全,直接 dt.replace(tzinfo=...) 会出错
  • 如果读的是用户输入或字符串(如 "2024-05-20 14:30"),先用 datetime.fromisoformat()strptime() 解析,再显式加上时区,别依赖系统本地时区

timezone.utc 是常量,不是函数

timezone.utcdatetime.timezone 类的一个实例,不是可调用对象。写成 timezone.utc() 会报 TypeError: 'datetime.timezone' object is not callable——这是新手高频错误。

它只适用于需要 UTC 时间的场景,比如记录日志、生成 token 过期时间、和外部服务对齐时间基准。

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

Unreal Images
Unreal Images

免费的AI图片库

下载
  • ✅ 正确:datetime.now(timezone.utc)datetime(2024, 1, 1, tzinfo=timezone.utc)
  • ❌ 错误:timezone.utc()datetime.now().replace(tzinfo=timezone.utc)(后者虽不报错,但若原 datetime 是本地时间,replace 会忽略夏令时偏移,逻辑错误)
  • 注意:timezone.utctimezone(timedelta(hours=0)) 等价,但前者更语义清晰、性能略好

ZoneInfo("Asia/Shanghai") 比 pytz 更可靠

Python 3.9 引入的 zoneinfo 模块,底层用 IANA 时区数据库,能正确处理历史夏令时变更、政区调整等细节;而 pytzlocalize() 以外的用法(比如直接 astimezone())容易返回错误偏移。

如果你的环境支持 Python 3.9+,没理由继续用 pytz

  • 安装:标准库,无需 pip(但旧系统可能需要 pip install backports.zoneinfo
  • 使用:from zoneinfo import ZoneInfo,然后 datetime.now(ZoneInfo("Asia/Shanghai"))
  • ⚠️ 注意:"Asia/Shanghai" 不能写成 "CST""GMT+8"——这些缩写不唯一、不可靠,IANA 数据库不认
  • 查可用时区:ZoneInfo.available_timezones()(返回 set,很大,建议按需过滤)

time.sleep() 和 timezone 没关系,但 time.time() 有

time.sleep() 只管挂起线程,和时区完全无关;但 time.time() 返回的是 Unix timestamp(自 1970-01-01 UTC 起的秒数),本质是 UTC 标量。很多人误以为它是“本地时间戳”,导致用它算“今天零点”时出错。

真正需要时区感知的时间计算,应该用 datetime + ZoneInfo,而不是对 time.time() 做加减。

  • ❌ 错误:用 time.time() + 3600 * 8 算“北京时间一小时后”,忽略了夏令时、闰秒、系统时区配置异常
  • ✅ 正确:用 datetime.now(ZoneInfo("Asia/Shanghai")) + timedelta(hours=1)
  • 存数据库时,优先存 UTC timestamp(datetime.now(timezone.utc)),读取时再转本地显示——避免时区转换污染业务逻辑

事情说清了就结束。最麻烦的不是写对代码,而是让整个系统里所有时间操作都统一时区策略,尤其当 legacy 代码混着 pytzdatetime.utcnow()time.localtime() 一起用的时候。

热门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安装使用方法的更多内容。

349

2023.10.09

更新pip版本
更新pip版本

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

425

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、保存并关闭文件即可。

786

2024.12.23

python升级pip
python升级pip

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

359

2025.07.23

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

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

1553

2023.10.24

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6400

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

835

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1085

2023.12.21

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

561

2026.02.13

热门下载

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

精品课程

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

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

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

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