EDTF est une Value qui porte, sous forme de chaîne de date étendue ISO 8601-2, des dates à précision d’année ou de mois, avant notre ère, incertaines ou en intervalle (Codec 0x06EL/0x06FL).

ÉlémentValeur
NomEDTF (groupe pair/impair. Les noms par code figurent dans le tableau des membres ci-dessous)
TAG ID0x06EL·0x06FL
Section3 0011 (Value), offset C dans la section = 14~15
KindValue · famille : TIME
Description d’indexchaîne de date EDTF (ISO 8601-2). Nombre d’octets pair ou impair. On ne l’utilise pas pour une date qui peut s’écrire en GREGORIAN-DATE
Côté Hugovalue/time/edtf.md

Membres

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

TAG IDNomNombre d’octetsCodec IDDocument de spécificationTAG WORD
0x06ELEDTF-EVENpair0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDimpair0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 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#2valeur brute restante (0xFFFF)

EDTF est une Value qui porte une date sous forme de chaîne Extended Date/Time Format (Bibliothèque du Congrès, ISO 8601-2:2019). Elle exprime une précision plus grossière que le jour, une date avant notre ère, l’incertain, l’approximatif ou le partiellement inconnu, et les intervalles.

Disposition

  • Code : code direct Value 0x06EL (nombre d’octets pair) · 0x06FL (nombre d’octets impair). Famille TIME. Le Payload est une chaîne, mais on le place dans la 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. C’est 2 × nombre de WORD du Payload − bit de poids faible, et il n’y a pas de Byte Count (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = nombre d'octets impair)
[TAG d'extension de Length] à partir de 15 WORD au total
Payload WORD 1st ... Nth          octets ASCII de la chaîne EDTF / si impair, dernier 0x00

Interprétation et validité

  • La suite d’octets est une chaîne ASCII conforme à la grammaire EDTF Level 0·1·2. Une chaîne vide est invalid.
  • Exemples : jour 1952-03-11, mois 1952-03, année 1952, décennie 195X, 44 av. J.-C. -0043, incertain 1974?, approximatif ~1974, intervalle 1952/2001, grande année Y-13799999999.
  • Les années suivent la notation astronomique de l’ISO 8601. 0000 est 1 av. J.-C., -0043 est 44 av. J.-C. Lorsqu’on transpose depuis une notation historique, on décale d’une année.
  • C’est le calendrier grégorien. EDTF ne traite pas d’autres calendriers. La notation d’origine d’un autre calendrier, tel le calendrier julien, est conservée dans GEDCOM-DATE. La valeur qui transpose le même jour ou la même période de cette date en calendrier grégorien peut s’écrire en EDTF ou en GREGORIAN-DATE.
  • Forme canonique : une date qui peut s’écrire exactement en GREGORIAN-DATE, c’est-à-dire [-]YYYY-MM-DD sans qualificateur (?, ~, %), sans chiffre inconnu (X), sans intervalle ni préfixe Y, s’écrit en GREGORIAN-DATE. Écrire une telle date en EDTF est invalid. Ce n’est que si un même jour n’est écrit que dans un seul format qu’on peut l’indexer et le comparer comme un temps.
  • Le schema ne vérifie pas encore la grammaire EDTF. Le producteur la vérifie avec un analyseur EDTF. Par exemple parser.ParseString de github.com/sfomuseum/go-edtf (BSD-3-Clause). parser.IsValid ne regarde que la grammaire et laisse passer 2023-02-29 et 1974-13 ; on ne l’utilise donc pas. Cet analyseur ne prend pas encore en charge les années à préfixe Y.

Longueur

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

Exemple

DateOctetsWORD au total
19744 (pair)06E2 3139 3734
197X4 (pair)06E2 3139 3758
1952-037 (impair)06F4 3139 3532 2D30 3300

Fondement normatif

Problèmes ouverts

  • Vérification de la grammaire EDTF par le vérificateur (si le vérificateur s’appuie ou non sur une bibliothèque externe).
  • Règle de transposition des précisions siècle et millénaire de Wikidata en chiffres inconnus EDTF.

Pages liées

Texte source du document de spécification

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006E000000000
BODY
#1 DECLARE 0x06E0
#2 FIELD #1 rest
#3 BIND #1 "EDTF-EVEN"
#4 BIND #2 "bytes"

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