DURATION-NANOSECONDS는 epoch이 없는 signed nanosecond 경과 시간이다. instant나 달력의 월·연 기간이 아니다.

항목값
이름DURATION-NANOSECONDS (규격 문서 BIND DURATION-NANOSECONDS)
TAG ID0x081L
코덱 ID0x00000810
규격 문서0x00000000/codecs/0x00000810/ (DECLARE 대상 0810)
섹션4 0100 (Value), 섹션 안 오프셋 C = 1
KindValue · 계열: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
색인 설명epoch 없는 signed nanosecond 경과 시간
Hugo 쪽value/time/duration-nanoseconds.md

필드 (규격 문서)

FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서).

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1nanoseconds#2날값 4 WORD

레이아웃

  • 코드: Value 직접 코드 0x081L. 계열 TIME.
  • Arrow Duration(NANOSECOND)와 같은 고정폭 signed int64 물리 타입을 쓴다.
TAG WORD          0x0814 (0000 1000 0001 0100)  전체 5 WORD
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다. 부호는 경과 방향이며 특정 epoch의 instant를 가리키지 않는다.
  • 작은 값도 항상 4 WORD를 쓴다.

길이

  • 전체는 TAG 1 WORD와 Payload 4 WORD를 합한 정확히 5 WORD이고 직접 길이 LLLL=0100을 쓴다. Length 확장 TAG, descriptor, padding은 없다.
  • Payload가 정확히 4 WORD가 아니면 거부한다.

예시

  • 0ns는 Payload 0000 0000 0000 0000, 전체 5 WORD, LLLL=0100이다. 전체는 0814 0000 0000 0000 0000이다.
  • 1ns는 Payload 0000 0000 0000 0001이다.
  • -1ns는 Payload FFFF FFFF FFFF FFFF이다.

표준 근거

  • Apache Arrow Columnar Format은 Schema.fbs를 Arrow 표준 데이터 타입의 authoritative source로 지정한다.
  • Arrow의 authoritative Schema.fbs에서 Duration은 달력과 무관한 절대 경과 시간이며, NANOSECOND 단위를 지원하고 항상 8-byte signed integer로 표현된다. GEUL은 여기에 TAG와 big-endian 16비트 WORD framing만 더한다.

규격 문서 원문

규격 문서 0x00000000/codecs/0x00000810/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000081000000000
BODY
#1 DECLARE 0x0810
#2 FIELD #1 0x0004
#3 BIND #1 "DURATION-NANOSECONDS"
#4 BIND #2 "nanoseconds"