ElementoValor
NombreGREGORIAN-DATE (documento de especificación BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec ID0x000006A0
Documento de especificación0x00000000/codecs/0x000006A0/ (destino de DECLARE 06A0)
Sección3 0011 (Value), desplazamiento C dentro de la sección = 10
KindValue · familia: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
Descripción del índicenúmero de días con signo respecto al 1970-01-01 gregoriano proléptico
Lado Hugovalue/time/gregorian-date.md

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato receptor (CODEC)ENUM
1days#2valor en bruto, 2 WORD

GREGORIAN-DATE es un número de días con signo que toma el 1970-01-01 del calendario gregoriano proléptico como day 0. No contiene zona horaria ni hora del día.

Layout

  • Código: código directo de Value 0x06AL. Familia TIME.
  • Usa el mismo tipo físico int32 con signo de ancho fijo que Arrow Date32 y DATE de Parquet.
TAG WORD          0x06A2 (0000 0110 1010 0010)  total 3 WORD
Payload WORD 1st (bits 31..16)     Signed Day Count high 16bit
Payload WORD 2nd (bits 15..0)      Signed Day Count low 16bit

Interpretación y validez

  • Los 2 WORD del Payload se leen como un day count con signo de 32 bits en complemento a dos, en orden de WORD big-endian.
  • El rango válido es de -2^31 a 2^31-1 días. Los negativos son fechas anteriores al epoch.
  • Al calcular año, mes y día a partir del day count se usa el calendario gregoriano proléptico, sin cambios históricos de calendario.
  • Incluso los valores pequeños usan siempre 2 WORD.

Longitud

  • El total es exactamente 3 WORD: 1 WORD de TAG más 2 WORD de Payload, y usa la longitud directa LLLL=0010. No hay TAG de extensión de Length, descriptor ni padding.
  • Si el Payload no es exactamente 2 WORD, se rechaza.

Ejemplo

FechaPayloadLength total
1970-01-010000 00003 WORD (LLLL=0010)
1970-01-020000 00013 WORD (LLLL=0010)
1969-12-31FFFF FFFF3 WORD (LLLL=0010)

Relación con EDTF

  • Las precisiones más gruesas que el día, lo incierto o aproximado y los intervalos se escriben con EDTF. Una fecha que se pueda escribir exactamente con GREGORIAN-DATE no se escribe con EDTF (forma canónica de EDTF).

Fundamento normativo

  • El DATE de Apache Parquet Logical Types es un int32 que guarda el número de días desde el epoch de Unix, 1970-01-01, y usa orden con signo.
  • Date32 de Apache Arrow Columnar Format y del Schema.fbs autoritativo guarda el número de días desde el epoch de Unix como entero de 32 bits con signo.
  • El cálculo gregoriano proléptico es el perfil de calendario de GEUL adoptado por este formato. Se conserva el significado de day-count int32 de Arrow/Parquet y solo se añaden el TAG y el framing de WORD de 16 bits big-endian.

Texto original del documento de especificación

Es el aspecto del documento de especificación 0x00000000/codecs/0x000006A0/latest.geul leído con geul show (hexadecimal en mayúsculas).

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