| 항목 | 값 |
|---|---|
| 이름 | CIVIL-TIME-NANOSECONDS (규격 문서 BIND CIVIL-TIME-NANOSECONDS) |
| TAG ID | 0x06BL |
| 코덱 ID | 0x000006B0 |
| 규격 문서 | 0x00000000/codecs/0x000006B0/ (DECLARE 대상 06B0) |
| 섹션 | 3 0011 (Value), 섹션 안 오프셋 C = 11 |
| Kind | Value · 계열: TIME |
| TAG WORD | 0000 0110 1011 LLLL (000K KKKC CCCC LLLL) |
| 색인 설명 | 민사일 자정 후 unsigned nanosecond 계수 |
| Hugo 쪽 | value/time/civil-time-nanoseconds.md |
필드 (규격 문서)
FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서).
| 순서 | 필드(BIND) | FIELD | 폭 | 받는 형식(CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | nanoseconds | #2 | 날값 4 WORD |
CIVIL-TIME-NANOSECONDS는 날짜 없는 민사시각을 자정 후 nanosecond 수로 나타낸다.
레이아웃
- 코드: Value 직접 코드
0x06BL. 계열 TIME. - Parquet
TIME(isAdjustedToUTC=false, unit=NANOS)와 같은 고정폭 signed int64 물리 타입을 쓴다.
TAG WORD 0x06B4 (0000 0110 1011 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로 읽는다.
- 물리 타입은 signed int64지만 유효 범위는
0 <= value < 86,400×10^9ns다. 음수와 상한 이상은 거부한다. 24:00과 윤초 label은 허용하지 않는다. 날짜, 타임존, UTC offset도 담지 않는다.- 작은 값도 항상 4 WORD를 쓴다.
길이
- 전체는 TAG 1 WORD와 Payload 4 WORD를 합한 정확히 5 WORD이고 직접 길이
LLLL=0100을 쓴다. Length 확장 TAG, descriptor, padding은 없다. - Payload가 정확히 4 WORD가 아니면 거부한다.
예시
- 자정은 Payload
0000 0000 0000 0000, 전체 5 WORD,LLLL=0100이다. - 자정 후 1ns는 Payload
0000 0000 0000 0001이다. 86,400×10^9ns는 상한과 같으므로 유효하지 않다.FFFF FFFF FFFF FFFF는 signed int64로 -1이므로 유효하지 않다.
표준 근거
- Apache Parquet Logical Types의
TIME(isAdjustedToUTC=false, unit=NANOS)는 local time의 자정 후 nanosecond를int64에 저장하며 signed 순서를 쓴다. - Apache Arrow Columnar Format의 authoritative Schema.fbs는 NANOSECOND Time을 64비트 signed integer로 정의하고, 유효 범위를 자정 포함 86,400초 미만으로 제한하며 윤초를 허용하지 않는다. GEUL은 TAG와 big-endian 16비트 WORD framing만 더한다.
규격 문서 원문
규격 문서 0x00000000/codecs/0x000006B0/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).
SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006B000000000
BODY
#1 DECLARE 0x06B0
#2 FIELD #1 0x0004
#3 BIND #1 "CIVIL-TIME-NANOSECONDS"
#4 BIND #2 "nanoseconds"