POSIX-TIMESTAMP-NANOSECONDS 是自 Unix epoch 1970-01-01T00:00:00Z 起的 signed nanosecond 数。如同 POSIX 的 seconds-since-the-Epoch,将每一天都视为恰好 86,400 秒,不计闰秒。
布局
- 码:Value
VALUE-ISSUER-2WORD(0x09DL),Issuer0x0000000DIEEE,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。