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, 코덱 번호 0x00004000. 계열 TIME.
  • 산업 데이터 교환을 위해 Parquet TIMESTAMP(isAdjustedToUTC=true, unit=NANOS)와 같은 고정폭 signed int64 물리 타입을 쓴다.
TAG WORD          0x09D8 (0000 1001 1101 1000)  전체 9 WORD
Issuer            2 WORD  0x0000000D (IEEE)
코덱 번호         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, 코덱 번호 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만 더한다.