ÉlémentValeur
NomGREGORIAN-DATE (document de spécification BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec ID0x000006A0
Document de spécification0x00000000/codecs/0x000006A0/ (cible DECLARE 06A0)
Section3 0011 (Value), offset C dans la section = 10
KindValue · famille : TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
Description d’indexnombre de jours signed par rapport au 1970-01-01 du calendrier grégorien proleptique
Côté Hugovalue/time/gregorian-date.md

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1days#2valeur brute 2 WORD

GREGORIAN-DATE est un nombre de jours signed qui prend le 1970-01-01 du calendrier grégorien proleptique comme jour 0. Il ne porte ni fuseau horaire ni heure de la journée.

Disposition

  • Code : code direct Value 0x06AL. Famille TIME.
  • On utilise le même type physique int32 signed de largeur fixe que Date32 d’Arrow et 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

Interprétation et validité

  • Les 2 WORD du Payload sont lus comme un day count signed en complément à deux sur 32 bits, dans l’ordre des WORD big-endian.
  • L’intervalle valide va de -2^31 à 2^31-1 jours. Une valeur négative est une date antérieure à l’epoch.
  • Pour retrouver l’année, le mois et le jour à partir du day count, on utilise le calendrier grégorien proleptique, sans transition historique de calendrier.
  • Même une petite valeur occupe toujours 2 WORD.

Longueur

  • Le total est exactement de 3 WORD, soit 1 WORD de TAG plus 2 WORD de Payload, avec la longueur directe LLLL=0010. Il n’y a ni TAG d’extension de Length, ni descriptor, ni padding.
  • Si le Payload n’est pas exactement de 2 WORD, il est rejeté.

Exemple

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

Relation avec EDTF

  • Une précision plus grossière que le jour, l’incertain ou l’approximatif, et les intervalles s’écrivent en EDTF. Une date qui peut s’écrire exactement en GREGORIAN-DATE ne s’écrit pas en EDTF (forme canonique EDTF).

Fondement normatif

  • Le DATE des Apache Parquet Logical Types est un int32 qui stocke le nombre de jours depuis l’epoch Unix, le 1970-01-01, avec un ordre signed.
  • Date32 de l’Apache Arrow Columnar Format et du Schema.fbs faisant autorité stocke le nombre de jours depuis l’epoch Unix dans un entier signed de 32 bits.
  • Le calcul inverse dans le calendrier grégorien proleptique est le calendar profile de GEUL adopté par ce format. Le sens int32 day-count d’Arrow/Parquet est conservé tel quel, et l’on n’ajoute que le TAG et le framing en WORD de 16 bits big-endian.

Texte source du document de spécification

Voici le document de spécification 0x00000000/codecs/0x000006A0/latest.geul tel que lu par geul show (hexadécimal en majuscules).

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