항목값
이름GREGORIAN-DATE (규격 문서 BIND GREGORIAN-DATE)
TAG ID0x06AL
코덱 ID0x000006A0
규격 문서0x00000000/codecs/0x000006A0/ (DECLARE 대상 06A0)
섹션3 0011 (Value), 섹션 안 오프셋 C = 10
KindValue · 계열: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
색인 설명proleptic Gregorian 1970-01-01 기준 signed 날짜 수
Hugo 쪽value/time/gregorian-date.md

필드 (규격 문서)

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

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

GREGORIAN-DATE는 proleptic Gregorian 1970-01-01을 day 0으로 하는 signed 날짜 수다. 타임존과 하루 중 시각은 담지 않는다.

레이아웃

  • 코드: Value 직접 코드 0x06AL. 계열 TIME.
  • Arrow Date32, Parquet DATE와 같은 고정폭 signed int32 물리 타입을 쓴다.
TAG WORD          0x06A2 (0000 0110 1010 0010)  전체 3 WORD
Payload WORD 1st (bits 31..16)     Signed Day Count high 16bit
Payload WORD 2nd (bits 15..0)      Signed Day Count low 16bit

해석과 유효성

  • Payload 2 WORD 전체를 big-endian WORD 순서의 32비트 2의 보수 signed day count로 읽는다.
  • 유효 범위는 -2^31~2^31-1일이다. 음수는 epoch 이전 날짜다.
  • day count를 연·월·일로 역산할 때는 역사적 역법 전환 없이 proleptic Gregorian calendar를 쓴다.
  • 작은 값도 항상 2 WORD를 쓴다.

길이

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

예시

날짜Payload전체 Length
1970-01-010000 00003 WORD (LLLL=0010)
1970-01-020000 00013 WORD (LLLL=0010)
1969-12-31FFFF FFFF3 WORD (LLLL=0010)

EDTF와의 관계

  • 날보다 거친 정밀도, 불확실·대략, 구간은 EDTF로 쓴다. GREGORIAN-DATE로 정확히 쓸 수 있는 날짜는 EDTF로 쓰지 않는다(EDTF 정규형).

표준 근거

  • Apache Parquet Logical Types의 DATE는 Unix epoch인 1970-01-01부터의 일수를 저장하는 int32이며 signed 순서를 쓴다.
  • Apache Arrow Columnar Format과 authoritative Schema.fbs의 Date32는 Unix epoch부터의 일수를 32비트 signed integer로 저장한다.
  • proleptic Gregorian 역산은 이 형식이 채택한 GEUL calendar profile이다. Arrow/Parquet의 int32 day-count 의미는 그대로 두고 TAG와 big-endian 16비트 WORD framing만 더한다.

규격 문서 원문

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006A000000000
BODY
#1 DECLARE 0x06A0
#2 FIELD #1 0x0002
#3 BIND #1 "GREGORIAN-DATE"
#4 BIND #2 "days"