时区处理利器~pytz

发表于2025年3月2日2025年3月3日作者桔子菌

内容目录

安装方法
应用场景
基本用法
高级功能
总结

pytz 是一个广泛使用的 Python 第三方库，专注于处理时区问题。它基于 IANA 时区数据库，提供了精确的时区信息，并与 Python 标准库的 datetime 模块无缝集成。无论是跨时区的时间转换、处理夏令时，还是本地化时间操作，pytz 都是开发者的首选工具。

安装方法

安装 pytz 可以通过 pip 命令直接完成：


pip install pytz

应用场景

全球化系统：处理多时区用户的时间显示。
金融交易：精准对接不同交易所的开市时间。
数据分析：清洗跨时区的时间序列数据。

基本用法

pytz可以用来进行时区转换，获取时区信息，处理夏令时等：

1. 时区转换

#juzicode.com/VX公众号:juzicode
from datetime import datetime
import pytz

utc_time = datetime.now(pytz.utc)
shanghai_tz = pytz.timezone('Asia/Shanghai')
local_time = utc_time.astimezone(shanghai_tz)
print(local_time)  # 输出: UTC 时间转换为上海时区的当前时间

2. 本地化时间

#juzicode.com/VX公众号:juzicode
import pytz
from datetime import datetime

naive_time = datetime(2023, 10, 5, 14, 30)
new_york_tz = pytz.timezone('America/New_York')
localized_time = new_york_tz.localize(naive_time)
print(localized_time)  # 输出: 2023-10-05 14:30:00-04:00（夏令时）

3. 获取时区信息

#juzicode.com/VX公众号:juzicode
import pytz

tz_list = pytz.all_timezones[:5]  # 获取前5个时区名称
print(tz_list)  # 输出: ['Africa/Abidjan', 'Africa/Accra', ...]
europe_tz = [tz for tz in pytz.all_timezones if tz.startswith('Europe')]
print(europe_tz[:3])  # 输出: ['Europe/Amsterdam', 'Europe/Andorra', ...]

4. 处理夏令时

#juzicode.com/VX公众号:juzicode
import pytz
from datetime import datetime

tz = pytz.timezone('Europe/London')
dt = datetime(2023, 3, 26, 1, 30)
local_dt = tz.localize(dt, is_dst=None)  # 强制检查夏令时,会抛异常pytz.exceptions.NonExistentTimeError: 2023-03-26 01:30:00

local_dt = tz.localize(dt)  # 不检查
print(local_dt)  # 输出: 2023-03-26 01:30:00+00:00

5. 结合 pandas 处理时区

#juzicode.com/VX公众号:juzicode
import pandas as pd
import pytz

df = pd.DataFrame({'time': ['2023-10-05 08:00', '2023-10-05 12:00']})
df['time'] = pd.to_datetime(df['time']).dt.tz_localize(pytz.utc)
print(df['time'].dt.tz)  # 输出: UTC

高级功能

pytz 还支持更复杂的时区操作，比如历史时区变化处理，时区偏移计算，夸时区对比等：

1. 历史时区变化处理

#juzicode.com/VX公众号:juzicode
import pytz
from datetime import datetime

tz = pytz.timezone('Asia/Shanghai')
dt = datetime(1940, 6, 1, 12, 0)
local_dt = tz.localize(dt)
print(local_dt)  # 输出: 1940-06-01 12:00:00+09:00（历史时区偏移）

2. 时区偏移计算

#juzicode.com/VX公众号:juzicode
from datetime import datetime
import pytz

tz = pytz.timezone('Australia/Lord_Howe')
dt = datetime(2023, 10, 5, 12, 0)
local_dt = tz.localize(dt)
print(local_dt.utcoffset())  # 输出: 11:00:00

3. 动态时区规则应用

#juzicode.com/VX公众号:juzicode
import pytz
from dateutil import parser

dt = parser.parse("2023-03-12 02:30:00")
tz = pytz.timezone('America/Chicago')
try:
    local_dt = tz.localize(dt, is_dst=None)
except pytz.AmbiguousTimeError:
    local_dt = tz.localize(dt, is_dst=True)
print(local_dt)  # 输出 2023-03-12 02:30:00-05:00  处理模糊时间（夏令时切换）

4. 生成时区感知时间范围

#juzicode.com/VX公众号:juzicode
import pytz
from datetime import datetime, timedelta

start = datetime(2023, 10, 1, tzinfo=pytz.utc)
dates = [start + timedelta(days=i) for i in range(7)]
print(dates[5])  # 输出: 2023-10-06 00:00:00+00:00

5. 时区信息序列化

#juzicode.com/VX公众号:juzicode
import pytz
import json
from datetime import datetime

tz = pytz.timezone('Asia/Tokyo')
dt = datetime.now(tz)
data = {
    "time": dt.isoformat(),
    "timezone": str(tz)
}
print(json.dumps(data))  # 输出带时区信息的 JSON  {"time": "2025-02-23T23:35:03.426746+09:00", "timezone": "Asia/Tokyo"}

运行结果：

{"time": "2025-02-24T21:40:09.094728+09:00", "timezone": "Asia/Tokyo"}

6. 跨时区时间对比

#juzicode.com/VX公众号:juzicode
import pytz
from datetime import datetime

time_ny = datetime.now(pytz.timezone('America/New_York'))
time_london = datetime.now(pytz.timezone('Europe/London'))
print(f"纽约时间: {time_ny}\n伦敦时间: {time_london}")