POSIX-TIMESTAMP-NANOSECONDS 是自 Unix epoch 1970-01-01T00:00:00Z 起的 signed nanosecond 数。如同 POSIX 的 seconds-since-the-Epoch,将每一天都视为恰好 86,400 秒,不计闰秒。

布局

  • 码:Value VALUE-ISSUER-2WORD(0x09DL),Issuer 0x0000000D IEEE,Codec 编号 0x00004000。系列 TIME。
  • 为便于行业数据交换,使用与 Parquet TIMESTAMP(isAdjustedToUTC=true, unit=NANOS) 相同的定宽 signed int64 物理类型。
TAG WORD          0x09D8 (0000 1001 1101 1000)  总计 9 WORD
Issuer            2 WORD  0x0000000D (IEEE)
Codec 编号        2 WORD  0x00004000
Payload WORD 1st (bits 63..48)     Signed Nanoseconds high 16bit
Payload WORD 2nd (bits 47..32)     Signed Nanoseconds
Payload WORD 3rd (bits 31..16)     Signed Nanoseconds
Payload WORD 4th (bits 15..0)      Signed Nanoseconds low 16bit

解释与有效性

  • 将 Payload 4 WORD 整体读作 big-endian WORD 顺序的 64 位二进制补码 signed count。
  • 有效范围是 -2^63~2^63-1ns,instant 范围是 1677-09-21 00:12:43.145224192Z~2262-04-11 23:47:16.854775807Z。
  • 较小的值也始终使用 4 WORD。不得缩减为最小 WORD 整数表示。
  • 不承载 timezone、原始 UTC offset、闰秒 label、leap-second table。

长度

  • 总计是 TAG 1 WORD、Issuer 2 WORD、Codec 编号 2 WORD 与 Payload 4 WORD 之和,恰好 9 WORD,使用直接长度 LLLL=1000。没有 Length 扩展 TAG、descriptor、padding。
  • Payload 不是恰好 4 WORD 则拒绝。

示例

  • epoch 为 Payload 0000 0000 0000 0000,总计 9 WORD,LLLL=1000。
  • epoch 之后 1ns 为 Payload 0000 0000 0000 0001。
  • epoch 之前 1ns 为 Payload FFFF FFFF FFFF FFFF。

标准依据

  • POSIX.1-2024 timespec 定义了 time_t tv_sec 与 long tv_nsec 成员,以及 0 <= tv_nsec < 10^9。time_t 的具体宽度与表示取决于实现环境,且未定义将两个成员合并的累计 nanosecond signed int64 wire format。
  • POSIX.1-2024 Seconds Since the Epoch 将一天视为恰好 86,400 秒。
  • Apache Parquet Logical Types 的 TIMESTAMP(isAdjustedToUTC=true, unit=NANOS) 将自 Unix epoch 起的 nanosecond 存为单个 int64。GEUL 仅在此物理类型上增加 TAG 与 big-endian 16 位 WORD framing。