首页/数据/NoSQL 速查/时间戳精度与单位换算

时间戳精度与单位换算

时间戳位数直接对应单位:10 位约为秒、13 位约为毫秒、16 位约为微秒、19 位约为纳秒;写入与查询两侧的单位配置要一致。

NoSQL 速查数据更新于 2026-10-12
10 位秒级,如 1719792000,约 2024 年
13 位毫秒级,如 1719792000000
16 位微秒级,如 1719792000000000
19 位纳秒级,如 1719792000000000000(InfluxDB 默认)

示例

示例
# 快速判断时间戳单位(按数量级目测)
# 1719792000       -> 秒
# 1719792000000    -> 毫秒
# 1719792000000000000 -> 纳秒

# 写入时显式声明单位
gzip -c data.lp | curl -XPOST "http://127.0.0.1:8086/api/v2/write?org=my-org&bucket=metrics&precision=ms" \
  -H "Authorization: Token $INFLUX_TOKEN" -H "Content-Encoding: gzip" --data-binary @-
把单位写进数据管道文档并在采集端统一转换,比事后从数据分布反推更可靠。

易错点

  • 毫秒时间戳按默认纳秒写入会落到 1970 年附近,查询范围全空时先检查这一点
  • 不同语言的时间库默认单位不同,跨语言管道要在边界处显式转换

数据来源与参考

  • InfluxData Docs: Line protocol (timestamp precision)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌