项目值
名称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 为基准的 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 位二进制补码 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 与权威的 Schema.fbs 中的 Date32,将自 Unix epoch 起的日数存为 32 位 signed integer。
  • proleptic Gregorian 反推是本格式采用的 GEUL calendar profile。Arrow/Parquet 的 int32 day-count 含义保持不变,只加上 TAG 和 big-endian 16 位 WORD framing。

规格文档原文

用 geul show 读取规格文档 0x00000000/codecs/0x000006A0/latest.geul 的样子(十六进制为大写)。

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