GEDCOM-DATE est un Value qui conserve tel quel, sous forme de chaîne de valeur de date GEDCOM 7, une date d’un autre calendrier, comme le calendrier julien (Codec 0x070L/0x071L).

ÉlémentValeur
NomGEDCOM-DATE (groupe pair/impair. Le nom de chaque code figure dans le tableau des membres ci-dessous)
TAG ID0x070L·0x071L
Section3 0011 (Value), décalage dans la section C = 16~17
KindValue · famille : TIME
Description de l’indexChaîne de valeur de date GEDCOM 7. Conserve la notation d’origine des autres calendriers (julien, etc.). Octets pairs·impairs
Côté Hugovalue/time/gedcom-date.md

Membres

Cette page traite ensemble deux codes formant une paire pair/impair. Le code pair correspond à un nombre d’octets pair, le code impair à un nombre d’octets impair (Enregistrement et TAG WORD). Il y a un document de Codec par code. Les champs des deux documents de Codec sont identiques ; seuls la cible de DECLARE et le nom (BIND) diffèrent.

TAG IDNomNombre d’octetsCodec IDDocument de spécificationTAG WORD
0x070LGEDCOM-DATE-EVENpair0x000007000x00000000/codecs/0x00000700/0000 0111 0000 LLLL
0x071LGEDCOM-DATE-ODDimpair0x000007100x00000000/codecs/0x00000710/0000 0111 0001 LLLL

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
1bytes#2reste de valeur brute (0xFFFF)

GEDCOM-DATE est un Value qui contient la chaîne de valeur de date (DateValue) de GEDCOM 7 (FamilySearch). Il conserve tel qu’écrit une date que la source a notée dans un calendrier autre que grégorien (julien, etc.).

Disposition

  • Code : codes directs de Value 0x070L (octets pairs) · 0x071L (octets impairs). Famille TIME.
  • Le nombre d’octets est déterminé par le bit de poids faible du Codec et par le nombre de WORD du Payload. Il vaut 2 × nombre de WORD du Payload − bit de poids faible, et il n’y a pas de Byte Count (Value).
TAG WORD          0000 0111 000P LLLL      Codec 0x070L/0x071L (P = octets impairs)
[TAG d'extension Length] si le total atteint 15 WORD ou plus
Payload WORD 1st ... Nth          octets ASCII de la chaîne de date GEDCOM / si impair, dernier 0x00

Interprétation et validité

  • La suite d’octets est une chaîne ASCII conforme à la grammaire DateValue de GEDCOM 7. La chaîne vide est invalid. GEDCOM autorise un DateValue vide, mais s’il n’y a pas de valeur, on n’écrit pas l’enregistrement.
  • Grammaire en bref : [calendrier] [[jour] mois] année [BCE]. On fait précéder de ABT·CAL·EST (approximatif), BEF·AFT·BET … AND … (intervalle), FROM … TO … (période). Le séparateur est une seule espace.
  • Calendriers : GREGORIAN (par défaut si omis), JULIAN, FRENCH_R, HEBREW, TAG d’extension. Les noms de mois sont fixés par calendrier (le calendrier julien utilise les mêmes JAN…DEC que le grégorien).
  • L’année est de style historique. Il n’y a pas d’année 0, et les années avant notre ère portent BCE (44 BCE = 44 avant notre ère). Elle diffère d’un an du style astronomique d’EDTF et de GREGORIAN-DATE.
  • Le schema ne vérifie que le format des octets : ASCII 0x20~0x7E, non vide, sans espace en début ni en fin. La grammaire et l’existence réelle du jour sont vérifiées par le producteur. Exemple : gedcom.ParseDate de github.com/cacack/gedcom-go/v3 (MIT). Le Validate de cette bibliothèque ne vérifie le jour que dans le calendrier grégorien et laisse donc passer JULIAN 30 FEB 1100, et ToGregorian ne convertit pas réellement les précisions année·mois. La vérification de l’existence de la date et la normalisation se font séparément.
  • Où l’utiliser : une date grégorienne s’écrit en GREGORIAN-DATE ou en EDTF. GEDCOM-DATE s’utilise pour les dates d’autres calendriers dont il faut conserver la notation d’origine.

Utilisation avec une valeur normalisée

  • Pour comparer et indexer la même date sur l’axe du temps, une valeur grégorienne est nécessaire. En précision au jour, la correspondance exacte est le GREGORIAN-DATE du même jour ; en précision année·mois, c’est l’EDTF d’intervalle grégorien de cette période (JULIAN 1300 → 1300-01-09/1301-01-08).
  • La manière de porter ensemble la notation d’origine (GEDCOM-DATE) et la valeur normalisée dans deux Value n’est pas encore fixée (problème ouvert).

Longueur

  • Le total est le nombre de WORD : TAG 1 WORD, plus le TAG d’extension Length (s’il existe) et le Payload (Length).

Exemple

DateOctetsTotal de WORD
JULIAN 130011 (impair)0716 4A55 4C49 414E 2031 3330 3000

Fondement normatif

  • FamilySearch GEDCOM 7, Data types — Date, Appendix A: Calendars and Dates. Le dépôt de la spécification est sous licence Apache 2.0. GEUL ne fait que référencer le format et ne reproduit pas le texte de la spécification.
  • ISO 8601, EDTF, XSD et les identifiants de calendrier CLDR (u-ca) ne comportent pas le calendrier julien. GEDCOM 7 est un format d’échange public qui traite en une seule grammaire le préfixe de calendrier, les années avant notre ère, la précision et les qualificateurs.

Problèmes ouverts

  • Manière de porter ensemble la notation d’origine et la valeur normalisée (manière de relier les deux dans un seul TRIPLE).
  • Vérification de la grammaire GEDCOM par le schema.
  • Précision au siècle·à la décennie. GEDCOM n’a pas de format correspondant. Les dates qui ne peuvent pas être transposées depuis Wikidata gardent leur texte d’origine en UTF8-TEXT.

Pages liées

Texte original du document de spécification

Aspect du document de spécification 0x00000000/codecs/0x00000700/latest.geul lu avec geul show (hexadécimal en majuscules).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000070000000000
BODY
#1 DECLARE 0x0700
#2 FIELD #1 rest
#3 BIND #1 "GEDCOM-DATE-EVEN"
#4 BIND #2 "bytes"

Ce qui précède est le document de Codec de GEDCOM-DATE-EVEN (0x070L). Le document de Codec de l’autre membre (GEDCOM-DATE-ODD) ne diffère que par le Codec ID dans le DOC-ID, la cible de DECLARE et le nom lié en #1 (BIND).