Python模块:zoneinfo时区支持详解
ztj100 2025-08-01 22:14 4 浏览 0 评论
一、知识导图
二、知识讲解
(一)zoneinfo模块概述
zoneinfo模块是Python 3.9及以上版本引入的一个用于支持IANA时区数据库的模块。它提供了一种方便的方式来处理时区相关的日期和时间操作。
(二)ZoneInfo类
1. 构造器
原型:zoneinfo.ZoneInfo(key)
功能:创建一个代表指定IANA时区的ZoneInfo对象。
参数:
- key:字符串,表示IANA时区的键值,如"America/Los_Angeles"。
返回值:ZoneInfo对象。
应用及注意事项:
- key必须是相对的标准化POSIX路径形式,不能包含对上一层级的引用。
- 如果找不到匹配的时区文件,会引发ZoneInfoNotFoundError异常。
示例:
from zoneinfo import ZoneInfo
from datetime import datetime
dt = datetime(2020, 10, 31, 12, tzinfo=ZoneInfo("America/Los_Angeles"))
print(dt) # 输出: 2020-10-31 12:00:00-07:00
2. 替代构造器
原型:
- zoneinfo.ZoneInfo.from_file(file_obj, *, key=None)
- zoneinfo.ZoneInfo.no_cache(key)
功能:
- from_file:基于文件对象构造ZoneInfo对象。
- no_cache:绕过构造器缓存的替代构造器。
参数:
- file_obj:返回字节串的文件型对象。
- key:字符串,时区名称。
返回值:ZoneInfo对象。
应用及注意事项:
- from_file构造的对象不可被封存。
- no_cache构造的对象每次调用都会返回一个新对象,适用于测试或演示。
示例:
from zoneinfo import ZoneInfo
from datetime import datetime
# 使用no_cache构造器
dt = datetime(2020, 10, 31, 12, tzinfo=ZoneInfo.no_cache("America/Los_Angeles"))
print(dt) # 输出: 2020-10-31 12:00:00-07:00
3. 属性
属性:ZoneInfo.key
功能:返回传给构造器的key值。
示例:
from zoneinfo import ZoneInfo
zone = ZoneInfo("Pacific/Kwajalein")
print(zone.key) # 输出: Pacific/Kwajalein
4. 字符串表示
功能:调用str()方法返回ZoneInfo对象的字符串表示。
示例:
from zoneinfo import ZoneInfo
zone = ZoneInfo("Pacific/Kwajalein")
print(str(zone)) # 输出: Pacific/Kwajalein
5. 封存序列化
功能:ZoneInfo对象的序列化基于键,而不是所有过渡数据。
注意事项:
- 基于文件构造的ZoneInfo对象不能被封存。
- 反序列化时,反序列化过程会使用主构造器或绕过缓存的构造器。
示例:
import pickle
from zoneinfo import ZoneInfo
zone = ZoneInfo("Europe/Berlin")
pkl = pickle.dumps(zone)
b = pickle.loads(pkl)
print(zone is b) # 输出: True
(三)数据源
zoneinfo模块从系统时区数据库或tzdata包中获取时区信息。
1. 系统时区数据
如果系统有时区数据,zoneinfo模块会优先使用系统数据。
2. tzdata包
如果系统时区数据不可用,zoneinfo模块会回退到使用tzdata包。
3. 配置数据源
配置方式:
- 编译时配置
- 环境变量配置
- 运行时配置
环境变量:PYTHONTZPATH
示例:
export PYTHONTZPATH="/path/to/zoneinfo"
(四)函数
1. available_timezones函数
原型:
zoneinfo.available_timezones()
功能:获取所有可用IANA时区的键集合。
返回值:集合。
示例:
from zoneinfo import available_timezones
timezones = available_timezones()
print(timezones)
2. reset_tzpath函数
原型:zoneinfo.reset_tzpath(to=None)
功能:设置或重置模块的时区搜索路径。
参数:
- to:由字符串或os.PathLike组成的序列。
示例:
from zoneinfo import reset_tzpath
reset_tzpath(to=["/path/to/zoneinfo"])
(五)全局变量
1. TZPATH变量
功能:表示时区搜索路径的只读序列。
示例:
from zoneinfo import TZPATH
print(TZPATH)
(六)异常与警告
1. ZoneInfoNotFoundError异常
功能:当构造ZoneInfo对象时找不到指定的键时引发。
示例:
from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
try:
zone = ZoneInfo("Invalid/Timezone")
except ZoneInfoNotFoundError:
print("时区未找到")
2. InvalidTZPathWarning警告
功能:当PYTHONTZPATH包含无效组件时引发。
示例:
import os
from zoneinfo import InvalidTZPathWarning
os.environ["PYTHONTZPATH"] = "/relative/path"
# 会引发InvalidTZPathWarning
三、应用示例
案例1:处理时区转换
需求:将一个UTC时间转换为指定时区的时间,并处理夏令时转换。
代码:
from zoneinfo import ZoneInfo
from datetime import datetime, timedelta
# 创建UTC时间
dt_utc = datetime(2020, 11, 1, 8, tzinfo=ZoneInfo("UTC"))
# 转换为洛杉矶时区
los_angeles = ZoneInfo("America/Los_Angeles")
dt_la = dt_utc.astimezone(los_angeles)
print(dt_la) # 输出: 2020-11-01 01:00:00-07:00
# 增加一天,观察夏令时转换
dt_la_next_day = dt_la + timedelta(days=1)
print(dt_la_next_day) # 输出: 2020-11-02 01:00:00-08:00
案例2:列出所有可用时区
需求:列出所有可用的IANA时区。
代码:
from zoneinfo import available_timezones
timezones = available_timezones()
for tz in timezones:
print(tz)
四、学习路线
- 基础知识:了解Python的datetime模块和时区处理的基本概念。
- zoneinfo模块:学习zoneinfo模块的基本用法,包括ZoneInfo类的构造器、替代构造器、属性、字符串表示和封存序列化。
- 数据源配置:了解zoneinfo模块的数据源配置方式,包括编译时配置、环境变量配置和运行时配置。
- 函数和全局变量:学习zoneinfo模块的函数和全局变量的使用方法。
- 异常与警告:了解zoneinfo模块的异常与警告的处理方法。
- 应用案例:通过实际案例掌握zoneinfo模块的使用技巧。
五、学习总结
通过本培训,我们可以掌握zoneinfo模块的基本用法和高级特性。zoneinfo模块提供了一种方便的方式来处理时区相关的日期和时间操作,特别是在需要处理夏令时转换和跨时区操作时。
六、参考资料
- Python官方文档 - zoneinfo模块:(https://docs.python.org/zh-cn/3/library/zoneinfo.html)
- PEP 615 -- Support for the IANA Time Zone Database in the Standard Library:(https://peps.python.org/pep-0615/)
- PEP 495 -- Local Time Disambiguation:(https://peps.python.org/pep-0495/)
#编程# #学习# #python# #在头条记录我的2025#
相关推荐
- Jquery 详细用法
-
1、jQuery介绍(1)jQuery是什么?是一个js框架,其主要思想是利用jQuery提供的选择器查找要操作的节点,然后将找到的节点封装成一个jQuery对象。封装成jQuery对象的目的有...
- 前端开发79条知识点汇总
-
1.css禁用鼠标事件2.get/post的理解和他们之间的区别http超文本传输协议(HTTP)的设计目的是保证客户机与服务器之间的通信。HTTP的工作方式是客户机与服务器之间的请求-应答协议。...
- js基础面试题92-130道题目
-
92.说说你对作用域链的理解参考答案:作用域链的作用是保证执行环境里有权访问的变量和函数是有序的,作用域链的变量只能向上访问,变量访问到window对象即被终止,作用域链向下访问变量是不被允许的。...
- Web前端必备基础知识点,百万网友:牛逼
-
1、Web中的常见攻击方式1.SQL注入------常见的安全性问题。解决方案:前端页面需要校验用户的输入数据(限制用户输入的类型、范围、格式、长度),不能只靠后端去校验用户数据。一来可以提高后端处理...
- 事件——《JS高级程序设计》
-
一、事件流1.事件流描述的是从页面中接收事件的顺序2.事件冒泡(eventbubble):事件从开始时由最具体的元素(就是嵌套最深的那个节点)开始,逐级向上传播到较为不具体的节点(就是Docu...
- 前端开发中79条不可忽视的知识点汇总
-
过往一些不足的地方,通过博客,好好总结一下。1.css禁用鼠标事件...
- Chrome 开发工具之Network
-
经常会听到比如"为什么我的js代码没执行啊?","我明明发送了请求,为什么反应?","我这个网站怎么加载的这么慢?"这类的问题,那么问题既然存在,就需要去解决它,需要解决它,首先我们得找对导致问题的原...
- 轻量级 React.js 虚拟美化滚动条组件RScroll
-
前几天有给大家分享一个Vue自定义滚动条组件VScroll。今天再分享一个最新开发的ReactPC端模拟滚动条组件RScroll。...
- 一文解读JavaScript事件对象和表单对象
-
前言相信做网站对JavaScript再熟悉不过了,它是一门脚本语言,不同于Python的是,它是一门浏览器脚本语言,而Python则是服务器脚本语言,我们不光要会Python,还要会JavaScrip...
- Python函数参数黑科技:*args与**kwargs深度解析
-
90%的Python程序员不知道,可变参数设计竟能决定函数的灵活性和扩展性!掌握这些技巧,让你的函数适应任何场景!一、函数参数设计的三大进阶技巧...
- 深入理解Python3密码学:详解PyCrypto库加密、解密与数字签名
-
在现代计算领域,信息安全逐渐成为焦点话题。密码学,作为信息保护的关键技术之一,允许我们加密(保密)和解密(解密)数据。...
- 阿里Nacos惊爆安全漏洞,火速升级!(附修复建议)
-
前言好,我是threedr3am,我发现nacos最新版本1.4.1对于User-Agent绕过安全漏洞的serverIdentitykey-value修复机制,依然存在绕过问题,在nacos开启了...
- Python模块:zoneinfo时区支持详解
-
一、知识导图二、知识讲解(一)zoneinfo模块概述...
- Golang开发的一些注意事项(一)
-
1.channel关闭后读的问题当channel关闭之后再去读取它,虽然不会引发panic,但会直接得到零值,而且ok的值为false。packagemainimport"...
- Python鼠标与键盘自动化指南:从入门到进阶——键盘篇
-
`pynput`是一个用于控制和监控鼠标和键盘的Python库...
你 发表评论:
欢迎- 一周热门
- 最近发表
- 标签列表
-
- idea eval reset (50)
- vue dispatch (70)
- update canceled (42)
- order by asc (53)
- spring gateway (67)
- 简单代码编程 贪吃蛇 (40)
- transforms.resize (33)
- redisson trylock (35)
- 卸载node (35)
- np.reshape (33)
- torch.arange (34)
- npm 源 (35)
- vue3 deep (35)
- win10 ssh (35)
- vue foreach (34)
- idea设置编码为utf8 (35)
- vue 数组添加元素 (34)
- std find (34)
- tablefield注解用途 (35)
- python str转json (34)
- java websocket客户端 (34)
- tensor.view (34)
- java jackson (34)
- vmware17pro最新密钥 (34)
- mysql单表最大数据量 (35)