一、知识导图

二、知识讲解

（一）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插件大全与特效教程

Python模块:zoneinfo时区支持详解