百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术分类 > 正文

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)

四、学习路线

  1. 基础知识:了解Python的datetime模块和时区处理的基本概念。
  2. zoneinfo模块:学习zoneinfo模块的基本用法,包括ZoneInfo类的构造器、替代构造器、属性、字符串表示和封存序列化。
  3. 数据源配置:了解zoneinfo模块的数据源配置方式,包括编译时配置、环境变量配置和运行时配置。
  4. 函数和全局变量:学习zoneinfo模块的函数和全局变量的使用方法。
  5. 异常与警告:了解zoneinfo模块的异常与警告的处理方法。
  6. 应用案例:通过实际案例掌握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库...

取消回复欢迎 发表评论: