ItemValor
NomeGREGORIAN-DATE (BIND GREGORIAN-DATE do documento de especificação)
TAG ID0x06AL
Codec ID0x000006A0
Documento de especificação0x00000000/codecs/0x000006A0/ (alvo do DECLARE 06A0)
Seção3 0011 (Value), deslocamento C na seção = 10
KindValue · família: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
Descrição no índicenúmero signed de dias a partir de 1970-01-01 do calendário gregoriano proléptico
Lado Hugovalue/time/gregorian-date.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato recebido (CODEC)ENUM
1days#2valor bruto de 2 WORD

GREGORIAN-DATE é um número signed de dias que toma 1970-01-01 do calendário gregoriano proléptico como day 0. Não guarda fuso horário nem hora do dia.

Layout

  • Código: direct code de Value 0x06AL. Família TIME.
  • Usa o mesmo tipo físico de largura fixa int32 signed que o Date32 do Arrow e o DATE do 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

Interpretação e validade

  • As 2 WORD do Payload são lidas inteiras como um day count signed de 32 bits em complemento de dois, em ordem de WORD big-endian.
  • O intervalo válido é de -2^31 a 2^31-1 dias. Os negativos são datas anteriores ao epoch.
  • Ao reconverter o day count em ano, mês e dia, usa-se o calendário gregoriano proléptico, sem transições históricas de calendário.
  • Mesmo valores pequenos usam sempre 2 WORD.

Comprimento

  • O total é exatamente 3 WORD, somando 1 WORD de TAG e 2 WORD de Payload, e usa o comprimento direto LLLL=0010. Não há TAG de extensão de Length, descriptor nem padding.
  • Se o Payload não tiver exatamente 2 WORD, é rejeitado.

Exemplo

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

Relação com o EDTF

  • Precisão mais grosseira que o dia, incerteza ou aproximação e intervalos são escritos com EDTF. Uma data que pode ser escrita exatamente com GREGORIAN-DATE não se escreve em EDTF (forma canônica do EDTF).

Base normativa

  • O DATE do Apache Parquet Logical Types é um int32 que guarda o número de dias desde 1970-01-01, o Unix epoch, e usa a ordenação signed.
  • O Date32 do Apache Arrow Columnar Format e do Schema.fbs de referência guarda o número de dias desde o Unix epoch como inteiro signed de 32 bits.
  • A reconversão pelo calendário gregoriano proléptico é o calendar profile do GEUL adotado por este formato. Mantém-se o significado de day count int32 do Arrow/Parquet e acrescenta-se apenas o TAG e o enquadramento em WORD de 16 bits big-endian.

Texto original do documento de especificação

É o documento de especificação 0x00000000/codecs/0x000006A0/latest.geul lido com geul show (hexadecimal em maiúsculas).

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