pandas 2.0 要求显式指定时间单位，数值型输入必须带 unit 参数，字符串解析需统一格式或预处理，时区转换与算术运算全程保留纳秒精度，旧代码中省略 unit 或依赖自动推断的写法将报错。
Pandas 2.0 原生支持纳秒级时间戳，但必须显式指定 unit，且对输入格式更严格——不指定 unit 的数值型输入（如 1715432400000000000）在 2.0 中直接报错，而 1.x 可能误判为毫秒或微秒。
pd.Timestamp() 创建纳秒时间戳必须带 unit 参数
在 Pandas 2.0 中，pd.Timestamp() 接收整数输入时，unit 不再可选。例如：
-
pd.Timestamp(1715432400000000000)→ 报OutOfBoundsDatetime（因未指定单位，且数值 > 1e11） -
pd.Timestamp(1715432400000000000, unit="ns")→ 正确返回2024-05-12 05:00:00 -
pd.Timestamp(1715432400000, unit="ms")→ 毫秒级输入仍可用，但必须显式写unit="ms"
旧代码中省略 unit 的写法，在 2.0 升级后会立即失败，尤其常见于从传感器/数据库读取原始纳秒整数的场景。
to_datetime() 解析混合精度字符串需统一 format 或预处理
高频数据常混杂 "2024-05-12 10:00:00"（秒级）和 "2024-05-12 10:00:00.123456789"（纳秒级）。Pandas 2.0 默认不推断格式，直接解析会失败：
-
pd.to_datetime(["2024-05-12 10:00:00", "2024-05-12 10:00:00.123456789"])→ValueError: Unable to infer the format - 正确做法是：先用正则补零对齐（如把
"2024-05-12 10:00:00"→"2024-05-12 10:00:00.000000000"），再用format="%Y-%m-%d %H:%M:%S.%f"显式解析 - 或改用
pd.to_datetime(..., errors="coerce")+ 后续检查dt.nanosecond属性判断精度是否丢失
时区转换与算术运算保留纳秒精度
Pandas 2.0 的时区感知 DatetimeIndex 和 Timestamp 在 tz_convert()、tz_localize() 及加减 Timedelta 时，全程维持纳秒分辨率，不会降级为毫秒：
ts = pd.Timestamp("2024-05-12 10:00:00.123456789", tz="Asia/Shanghai")-
ts_utc = ts.tz_convert("UTC")→ 结果仍是纳秒级，且ts_utc.nanosecond == 123456789 -
ts + pd.Timedelta(nanoseconds=1)→ 精确递增 1 纳秒，不是四舍五入到微秒
这点在金融 tick 级回测或分布式系统日志对齐中很关键——精度丢失可能引发事件排序错误。
容易被忽略的兼容性断裂点
升级到 Pandas 2.0 后最易踩坑的是三类隐式行为消失：
- 不再自动识别数值型输入的单位：比如从 PostgreSQL 读出的
bigint时间戳列，原来靠启发式猜是毫秒，现在必须加unit="ms" -
errors="coerce"不再尝试“截断修复”：字符串"2024-05-12T10:00:00.123xxx"在 1.x 可能返回2024-05-12T10:00:00.123，2.0 直接变NaT -
pd.date_range()的freq若含纳秒（如"1000000ns"），必须确保所有参数（start,end,periods）类型一致，否则触发TypeError而非静默降频
实际迁移时，建议先用 pd.options.mode.chained_assignment = "warn" 并扫描所有 to_datetime 和 Timestamp 调用点，逐个补全 unit 与 format。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
