tz_localize用于给无时区datetime标注原始时区，仅声明不改变数值；不能用于已有时区对象，否则报错；必须传IANA时区名并显式处理夏令时边界。
tz_localize 什么时候用、为什么不能乱用
tz_localize 的作用是「给一个没有时区信息的 datetime 对象打上时区标签」，它不改变时间数值，只声明“这个时间原本就属于某个时区”。常见错误是拿已经带时区的时间再调用 tz_localize，会直接报错 TypeError: Already tz-aware。
典型使用场景：读取 CSV 或数据库里纯字符串/朴素 datetime（如 2023-05-10 14:30:00），你得先确认它原始对应哪个时区（比如服务器日志是 UTC，用户输入是 'Asia/Shanghai'），再用 tz_localize 标注。
- 必须传入明确的时区名，如
'UTC'或'Asia/Shanghai'，不能传None或空字符串 - 遇到夏令时边界时间（如 '2023-11-05 01:30:00' 在美国东部时间可能模糊），需显式指定
ambiguous=True/False或nonexistent='shift_forward' - pandas 1.4+ 默认对模糊时间抛异常，老版本可能静默选第一个——行为不一致，建议始终显式处理
tz_convert 才是真正做时区换算的函数
tz_convert 用于「把一个已有时区的时间，转换成另一个时区的等效本地时间」。它会根据时区规则自动计算偏移量变化，包括夏令时切换。这是实现“UTC → 本地时间”的关键一步。
注意：只能在已通过 tz_localize 或其他方式变成 tz-aware 的 Series / DatetimeIndex 上调用。对朴素时间直接调 tz_convert 会报 TypeError: Cannot convert tz-naive datetime。
立即学习“Python免费学习笔记（深入）”；
- 目标时区写法要标准，推荐用 IANA 时区名（
'Europe/London'），避免用'GMT+8'这类固定偏移——它不支持夏令时 - 若数据是 DataFrame 的某一列，别忘了先确保该列为
datetime64[ns, UTC]类型，否则.dt.tz_convert()会静默失败或返回 NaT - 批量转换时性能敏感？用
DatetimeIndex.tz_convert()比逐行.apply(lambda x: x.tz_convert(...))快 10 倍以上
完整链路：从字符串到本地时间的三步操作
真实场景中，你几乎不会单独用某一个方法。典型流程是：解析 → 定义原始时区 → 转为目标时区。例如把 API 返回的 ISO 字符串（带 Z）转成本地显示时间：
import pandas as pd
s = pd.Series(['2023-08-15T09:45:00Z', '2023-08-15T12:30:00Z'])
# 1. 解析为 tz-aware UTC 时间（pandas 自动识别 'Z'）
dti = pd.to_datetime(s)
# 2. 确认已是 UTC（可省略，但建议 assert dti.dt.tz == pytz.UTC）
# 3. 转成本地时区（如系统默认或指定）
local = dti.dt.tz_convert('Asia/Shanghai')如果原始数据没带时区标识（如 '2023-08-15 09:45:00'），就必须补 tz_localize：
naive = pd.to_datetime(['2023-08-15 09:45:00'])
utc_aware = naive.dt.tz_localize('UTC') # 声明它是 UTC 时间
shanghai_time = utc_aware.dt.tz_convert('Asia/Shanghai')容易被忽略的系统时区陷阱
很多人以为 tz_convert('localtime') 或类似写法能自动匹配系统时区——pandas 不支持这种 magic string。所谓“本地时间”必须显式指定，比如 'Asia/Shanghai' 或通过 time.tzname + zoneinfo 动态获取。
- Windows 用户注意：
'Asia/Shanghai'可用，但'CST'、'China Standard Time'无效，IANA 名称才可靠 - 部署到服务器时，别依赖开发机的时区设置；硬编码比环境探测更可控
- 用
pytz时，pytz.timezone('Asia/Shanghai').localize(...)和 pandas 的tz_localize行为略有差异（后者对夏令时更严格），混用易出错，建议全程用 pandas 内置时区处理
时区转换不是单纯加减小时，背后是整套地理政治规则。写死偏移量、跳过 tz_localize 直接算、或者把 tz_convert 当万能转换器——这三类操作在跨年、跨夏令时、跨地区场景下一定会翻车。
