什么是zoneinfo模块？

zoneinfo是Python 3.9引入的标准库模块，它提供了对IANA时区数据库的支持，替代了旧的pytz库。这个模块让时区处理变得简单而直观，不再需要额外的第三方库。

基本使用方法

1. 导入模块

首先导入必要的模块：

from datetime import datetime, timedelta
from zoneinfo import ZoneInfo

2. 创建时区感知的datetime对象

# 创建当前时间的时区感知对象
local_time = datetime.now(ZoneInfo("Asia/Shanghai"))
print("上海时间:", local_time)

# 创建特定时间的时区感知对象
new_york_time = datetime(2023, 10, 15, 12, 30, tzinfo=ZoneInfo("America/New_York"))
print("纽约时间:", new_york_time)

3. 时区转换

# 将纽约时间转换为伦敦时间
london_time = new_york_time.astimezone(ZoneInfo("Europe/London"))
print("伦敦时间:", london_time)

# 转换为UTC时间
utc_time = new_york_time.astimezone(ZoneInfo("UTC"))
print("UTC时间:", utc_time)

处理夏令时(DST)

zoneinfo自动处理夏令时转换，这是它最大的优势之一：

# 创建一个夏令时转换期间的时间
# 2023年3月12日美国东部时间凌晨2点（夏令时开始）
dt = datetime(2023, 3, 12, 1, 30, tzinfo=ZoneInfo("America/New_York"))

# 增加1小时 - 将跨越夏令时边界
dt_plus_1h = dt + timedelta(hours=1)

print("原时间:", dt)  # 2023-03-12 01:30:00-05:00
print("加1小时后:", dt_plus_1h)  # 2023-03-12 03:30:00-04:00

注意时间从凌晨1:30变成凌晨3:30，跳过了2点，同时UTC偏移从-5变为-4。

获取所有可用时区

可以使用zoneinfo.available_timezones()获取所有可用时区：

from zoneinfo import available_timezones

# 获取所有可用时区
all_zones = available_timezones()
print(f"总时区数: {len(all_zones)}")

# 打印前10个时区
print("示例时区:")
for zone in sorted(all_zones)[:10]:
    print(zone)

常见问题解决方案

pip install tzdata

from zoneinfo import ZoneInfo
from datetime import datetime, timedelta

# 2023年11月5日美国东部时间凌晨1:30（夏令时结束）
# 这个时间会出现两次（标准时间和夏令时）
ambiguous_time = datetime(2023, 11, 5, 1, 30, tzinfo=ZoneInfo("America/New_York"))

try:
    print(ambiguous_time)
except Exception as e:
    print(f"错误: {e}")

# 明确指定使用夏令时
dst_time = datetime(2023, 11, 5, 1, 30, tzinfo=ZoneInfo("America/New_York"), is_dst=True)
print("夏令时版本:", dst_time)

# 明确指定使用标准时间
std_time = datetime(2023, 11, 5, 1, 30, tzinfo=ZoneInfo("America/New_York"), is_dst=False)
print("标准时间版本:", std_time)

最佳实践

完整示例：会议时间转换器

from datetime import datetime
from zoneinfo import ZoneInfo

def convert_meeting_time(utc_time, target_timezone):
    """将UTC会议时间转换为目标时区时间"""
    utc_time = utc_time.replace(tzinfo=ZoneInfo("UTC"))
    return utc_time.astimezone(ZoneInfo(target_timezone))

# 在UTC时间2023-12-15 15:00举行会议
meeting_utc = datetime(2023, 12, 15, 15, 0)

# 转换为不同时区
timezones = ["Asia/Tokyo", "Europe/London", "America/Los_Angeles", "Australia/Sydney"]

print("全球会议时间:")
for tz in timezones:
    local_time = convert_meeting_time(meeting_utc, tz)
    print(f"{tz}: {local_time.strftime('%Y-%m-%d %H:%M')}")