本文介绍使用 xarray 的 `decode_cf()` 自动解析 netcdf 中的 cf 时间编码,并通过 `.astype(int)` 直接向量化转换为纳秒级 unix 时间戳,再缩放至毫秒,全程无需循环,兼顾精度与性能。
在处理 NetCDF 气象或气候数据时,时间坐标常以“days since YYYY-MM-DD”等 CF 兼容格式存储为浮点数(如 107.0 表示 2002-01-01 之后的 107 天),底层类型为 cftime.DatetimeGregorian 或类似对象。手动逐元素解析不仅低效,还易出错。幸运的是,xarray 提供了开箱即用的向量化解决方案:xarray.decode_cf()。
该函数会自动识别变量的 units 和 calendar 属性(注意:units 必须为小写 “days since…”,若原始属性为 “Units” 或首字母大写,需先修正),并将时间数组智能转换为 datetime64[ns] 类型的 DataArray——这是 NumPy 原生支持、可直接参与数值运算的时间类型。
转换为 Unix 时间戳(毫秒)的关键在于:datetime64[ns] 在底层以纳秒为单位存储自 Unix 纪元(1970-01-01T00:00:00Z)以来的偏移量。因此,只需调用 .astype(int) 即可获取纳秒值,再除以 1_000_000(即 1e6)即可得到毫秒级时间戳:
import xarray as xr
# 构造示例数据集(模拟从 NetCDF 读取的原始 time 数组)
attrs = {"units": "days since 2002-01-01T00:00:00"} # ⚠️ units 必须小写且格式规范
ds = xr.Dataset({
"time": ("time", [107.0, 129.5, 227.5, 7928.0, 7958.5, 7989.0], attrs)
})
# 第一步:CF 标准解码 → 得到 datetime64[ns]
decoded = xr.decode_cf(ds)
print("解码后时间:", decoded.time.values)
# 输出:['2002-04-18' '2002-05-10T12:00' ... '2023-11-16']
# 第二步:向量化转 Unix 毫秒时间戳
unix_ms = (decoded.time.astype(int) // 1_000_000).values
print("Unix 毫秒时间戳:", unix_ms)
# 输出:[1019088000000 1021032000000 1029499200000 ... 1700092800000]
✅ 优势总结: