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ビット2の補数 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の具体的な幅と表現は実装環境に依存し、2つのメンバーを合わせた累積 nanosecond の signed int64 wire format は定義しない。 - POSIX.1-2024 Seconds Since the Epoch は、1日を正確に86,400秒とみなす。
- Apache Parquet Logical Types の
TIMESTAMP(isAdjustedToUTC=true, unit=NANOS)は、Unix epoch からの nanosecond を単一のint64に格納する。GEUL はこの物理型に、TAG と big-endian 16ビット WORD の framing だけを加える。