如何检查DataFrame中时间戳列的所有条目均为UTC时区？

你遇到的错误是因为DataFrame的ts列包含混合时区的时间戳，导致该列 dtype 变为object而非统一的datetime64[ns, tz]，此时使用dt.tz会触发类型转换错误。以下是两种高效的实现方式：

方法1：兼容混合时区的逐个验证 #

直接检查每个时间戳的时区是否为UTC，适配列中存在不同时区的场景：

import pandas as pd

data = {
    'ts': [
        pd.Timestamp('2024-06-11 12:00:00', tz='UTC'),
        pd.Timestamp('2024-06-11 13:00:00', tz='UTC'),
        pd.Timestamp('2024-06-11 14:00:00', tz='US/Pacific')
    ],
}

df = pd.DataFrame(data)

# 验证每个时间戳的时区是否为UTC
all_utc = df['ts'].apply(lambda x: x.tz is not None and x.tz.zone == 'UTC')
assert all(all_utc), f"Some timestamps are not in UTC:\n{df[~all_utc]}"

方法2：先校验列级时区（适用于全列时区统一的场景） #

如果业务逻辑保证ts列所有时间戳时区一致，可以先检查列的整体时区：

# 先判断列是否为带时区的datetime类型
if pd.api.types.is_datetime64tz_dtype(df['ts']):
    all_utc = df['ts'].dt.tz.zone == 'UTC'
else:
    # 存在混合时区，转为逐个验证
    all_utc = df['ts'].apply(lambda x: x.tz is not None and x.tz.zone == 'UTC')

assert all(all_utc), f"Some timestamps are not in UTC:\n{df[~all_utc]}"

关键说明 #

• 当列中存在不同时区的时间戳时，pandas无法将其识别为datetime64[ns, tz]类型，只能存为object，此时必须逐个验证元素时区。
• 不能直接用x.tz == 'UTC'比较，因为x.tz返回的是时区对象（如pytz.utc），需通过tz.zone属性获取时区名称字符串再判断。

内容的提问来源于stack exchange，提问作者roulette01