本文介绍如何使用 pandas 内置的 format="ISO8601" 参数，一次性、高性能地解析同时包含 YYYY-MM-DD HH:MM:SS 和 YYYY-MM-DD HH:MM:SS.fff 两种格式的时间戳列，彻底避免 NaT 错误与自定义循环解析的性能瓶颈。
本文介绍如何使用 pandas 内置的 `format="iso8601"` 参数，一次性、高性能地解析同时包含 `yyyy-mm-dd hh:mm:ss` 和 `yyyy-mm-dd hh:mm:ss.fff` 两种格式的时间戳列，彻底避免 `nat` 错误与自定义循环解析的性能瓶颈。
在处理高频时序数据（如金融 tick 数据、传感器日志或工业 IoT 流）时，常遇到一种典型场景：时间戳列中混杂两种格式——整秒时间（如 "2023-12-30 00:00:00"）不带小数点，而亚秒时间（如 "2023-12-30 00:00:00.123"）则精确到毫秒甚至微秒。若直接调用 pd.to_datetime() 默认解析，pandas 会依据首行格式推断全局解析规则，导致其余格式不匹配的条目被强制转为 NaT，且无法通过 errors='coerce' 自动修复——这是由底层解析器的“单格式优先”机制决定的。
传统应对方案（如编写多格式尝试的 apply() 函数或分步掩码向量化解析）虽可行，但存在明显缺陷：前者因 Python 层逐行调用严重拖慢性能（尤其在百万级数据上可能慢 10–100 倍）；后者逻辑复杂、易出错，且仍需多次遍历数据。
真正的解决方案，藏在 pandas 2.0+ 的 ISO 8601 原生支持中。
format="ISO8601" 并非简单字符串匹配，而是启用 pandas 内部高度优化的 ISO 标准兼容解析器，可自动识别并统一处理：
- 完整 ISO 格式（YYYY-MM-DDTHH:MM:SS）
- 空格分隔变体（YYYY-MM-DD HH:MM:SS）
- 可选的小数秒部分（.f, .ff, .fff, .fffff 等，最长支持 6 位微秒）
- 时区信息（+00:00, Z, 或本地时区）
这意味着，无论你的数据以整秒开头还是亚秒开头，ISO8601 模式均能一次性、向量化、零 NaT 地完成解析，且性能媲美原生 to_datetime() 调用。
以下为完整示例：
import pandas as pd
# 模拟真实混合格式数据（注意：首行为整秒 / 首行为亚秒 两种典型 case）
timestamps_full_first = [
"2023-12-30 00:00:00",
"2023-12-30 00:00:00.1",
"2023-12-30 00:00:00.9",
"2023-12-30 00:00:01"
]
timestamps_sub_first = [
"2023-12-30 00:00:00.1",
"2023-12-30 00:00:00.9",
"2023-12-30 00:00:01",
"2023-12-30 00:00:01.1"
]
# ✅ 正确用法：指定 format="ISO8601"（pandas ≥ 2.0.0）
dt_full = pd.to_datetime(timestamps_full_first, format="ISO8601", utc=True, errors='coerce')
dt_sub = pd.to_datetime(timestamps_sub_first, format="ISO8601", utc=True, errors='coerce')
print("首行为整秒 → 全部成功解析：")
print(dt_full)
print("\n首行为亚秒 → 全部成功解析：")
print(dt_sub)输出结果（无 NaT）：
首行为整秒 → 全部成功解析：
DatetimeIndex(['2023-12-30 00:00:00+00:00',
'2023-12-30 00:00:00.100000+00:00',
'2023-12-30 00:00:00.900000+00:00',
'2023-12-30 00:00:01+00:00'],
dtype='datetime64[ns, UTC]')
首行为亚秒 → 全部成功解析：
DatetimeIndex(['2023-12-30 00:00:00.100000+00:00',
'2023-12-30 00:00:00.900000+00:00',
'2023-12-30 00:00:01+00:00',
'2023-12-30 00:00:01.100000+00:00'],
dtype='datetime64[ns, UTC]')✅ 关键优势总结：
- 零配置兼容性：无需预判格式顺序，无需维护格式列表；
- 极致性能：纯 C/Cython 实现，比 apply() 快 2–3 个数量级，比多轮掩码解析更简洁高效；
- 精度保障：自动保留原始亚秒精度（.1 → .100000，.1234567 → .123457 微秒四舍五入）；
- 健壮容错：配合 errors='coerce'，非法字符串仍返回 NaT，不影响有效数据。
⚠️ 注意事项：
- 仅适用于 pandas ≥ 2.0.0（2023 年 1 月发布），旧版本请升级；
- 若数据含非标准分隔符（如 T 缺失但有其他符号）、非 ISO 时区（如 "GMT+8"），需先清洗或改用 infer_datetime_format=False + 多格式回退；
- 对于超大文件（>1GB），建议结合 chunksize 分块读取，并在每块内应用 ISO8601 解析，避免内存峰值。
综上，当面对混合秒/亚秒时间戳时，format="ISO8601" 是最简洁、最高效、最符合工程实践的官方解决方案——告别手写解析逻辑，拥抱标准。
