ПараметрЗначение
ИмяGREGORIAN-DATE (документ спецификации BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec 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
На стороне Hugovalue/time/gregorian-date.md

Поля (документ спецификации)

Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1days#2простое значение, 2 WORD

GREGORIAN-DATE — знаковое число дней, где proleptic Gregorian 1970-01-01 принят за day 0. Часовой пояс и время суток не хранятся.

Раскладка

  • Код: прямой код Value 0x06AL. Семейство TIME.
  • Используется тот же физический тип — signed int32 фиксированной ширины, что у Arrow Date32 и Parquet DATE.
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

Интерпретация и действительность

  • Все 2 WORD Payload читаются как 32-битный signed day count в дополнительном коде с порядком WORD big-endian.
  • Допустимый диапазон — от -2^31 до 2^31-1 дней. Отрицательные значения — даты до epoch.
  • При обратном вычислении года, месяца и дня по day count используется proleptic Gregorian calendar без исторических переходов между календарями.
  • Даже малые значения всегда занимают 2 WORD.

Длина

  • Общая длина — ровно 3 WORD (TAG 1 WORD и Payload 2 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).

Стандартное обоснование

  • DATE в Apache Parquet Logical Types — int32, хранящий число дней от Unix epoch 1970-01-01, с упорядочением signed.
  • Date32 в Apache Arrow Columnar Format и авторитетном Schema.fbs хранит число дней от Unix epoch как 32-битное signed целое.
  • Обратное вычисление по proleptic Gregorian — профиль календаря GEUL, принятый в этом формате. Смысл int32 day-count из Arrow/Parquet сохраняется, добавляются только TAG и обрамление 16-битными WORD big-endian.

Исходный текст документа спецификации

Так выглядит документ спецификации 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"