EDTF ist ein Value, der mit erweiterten Datumszeichenketten nach ISO 8601-2 Daten mit Jahres- oder Monatsgenauigkeit, vor unserer Zeitrechnung, unsichere Daten und Intervalle aufnimmt (Codec 0x06EL/0x06FL).

EintragWert
NameEDTF (gerade/ungerade Gruppe. Die Namen je Code stehen in der Mitgliedertabelle unten)
TAG ID0x06EL·0x06FL
Abschnitt3 0011 (Value), Offset C im Abschnitt = 14 bis 15
KindValue · Familie: TIME
Index-BeschreibungEDTF-Datumszeichenkette (ISO 8601-2). Gerade und ungerade Bytezahl. Daten, die mit GREGORIAN-DATE geschrieben werden können, werden nicht damit geschrieben
Hugo-Seitevalue/time/edtf.md

Mitglieder

Diese Seite behandelt die beiden Codes des Paars gerade/ungerade gemeinsam. Der gerade Code ist ein Wert mit gerader Bytezahl, der ungerade Code ein Wert mit ungerader Bytezahl (Record und TAG WORD). Es gibt ein Codec-Dokument je Code. Die Felder der beiden Codec-Dokumente sind gleich, nur DECLARE-Ziel und Name (BIND) unterscheiden sich.

TAG IDNameBytezahlCodec IDSpezifikationsdokumentTAG WORD
0x06ELEDTF-EVENgerade0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDungerade0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 LLLL

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

Nr.Feld (BIND)FIELDBreiteZielformat (CODEC)ENUM
1bytes#2restlicher Rohwert (0xFFFF)

EDTF ist ein Value, der Daten als Zeichenkette im Extended Date/Time Format (Library of Congress, ISO 8601-2:2019) aufnimmt. Er stellt Genauigkeit gröber als Tage, Daten vor unserer Zeitrechnung, unsichere, ungefähre oder teilweise unbekannte Daten und Intervalle dar.

Layout

  • Code: direkter Value-Code 0x06EL (gerade Bytezahl) und 0x06FL (ungerade Bytezahl). Familie TIME. Der Payload ist eine Zeichenkette, wird aber in der Familie TIME geführt.
  • Die Bytezahl ergibt sich aus dem niedrigstwertigen Bit des Codec und der Anzahl der Payload-WORD. Sie ist 2 × Anzahl der Payload-WORD − niedrigstwertiges Bit, und es gibt keinen Byte Count (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = ungerade Bytezahl)
[Length-Erweiterungs-TAG] bei insgesamt 15 WORD oder mehr
Payload WORD 1st ... Nth          ASCII-Bytes der EDTF-Zeichenkette / bei ungerader Bytezahl zuletzt 0x00

Interpretation und Gültigkeit

  • Die Bytefolge ist eine ASCII-Zeichenkette nach der EDTF-Grammatik der Level 0, 1 und 2. Eine leere Zeichenkette ist invalid.
  • Beispiele: Tag 1952-03-11, Monat 1952-03, Jahr 1952, Jahrzehnt 195X, 44 v. Chr. -0043, unsicher 1974?, ungefähr ~1974, Intervall 1952/2001, großes Jahr Y-13799999999.
  • Die Jahre folgen der astronomischen Zählung nach ISO 8601. 0000 ist das Jahr 1 v. Chr., -0043 das Jahr 44 v. Chr. Bei der Übertragung aus historischer Schreibweise wird um ein Jahr verschoben.
  • Es ist der gregorianische Kalender. EDTF behandelt keine anderen Kalender. Die Originalschreibweise anderer Kalender wie des julianischen wird mit GEDCOM-DATE bewahrt. Der Wert, der denselben Tag oder Zeitraum dieses Datums in den gregorianischen Kalender überträgt, kann mit EDTF oder GREGORIAN-DATE geschrieben werden.
  • Normalform: Ein Datum, das sich exakt mit GREGORIAN-DATE schreiben lässt, also [-]YYYY-MM-DD ohne Qualifikator (?, ~, %), unbekannte Stellen (X), Intervall und Y-Präfix, wird mit GREGORIAN-DATE geschrieben. Ein solches Datum mit EDTF zu schreiben ist invalid. Nur wenn derselbe Tag in einem einzigen Format geschrieben wird, lässt er sich als Zeit indizieren und vergleichen.
  • Das Schema prüft die EDTF-Grammatik noch nicht. Der Produzent prüft mit einem EDTF-Parser. Beispiel: parser.ParseString von github.com/sfomuseum/go-edtf (BSD-3-Clause). parser.IsValid prüft nur die Grammatik und lässt auch 2023-02-29 und 1974-13 durch, wird also nicht verwendet. Dieser Parser unterstützt Jahre mit Y-Präfix noch nicht.

Länge

  • Die Gesamtzahl ist die Summe der WORD aus 1 WORD TAG, dem Length-Erweiterungs-TAG (falls vorhanden) und dem Payload (Length).

Beispiel

DatumBytesGesamt-WORD
19744 (gerade)06E2 3139 3734
197X4 (gerade)06E2 3139 3758
1952-037 (ungerade)06F4 3139 3532 2D30 3300

Normative Grundlage

Offene Probleme

  • Die Prüfung der EDTF-Grammatik durch den Prüfer (ob der Prüfer sich auf eine externe Bibliothek stützt).
  • Die Regel, mit der die Jahrhundert- und Jahrtausendgenauigkeit von Wikidata in unbekannte Stellen von EDTF übertragen wird.

Verwandte Seiten

Originaltext des Spezifikationsdokuments

Das Spezifikationsdokument 0x00000000/codecs/0x000006E0/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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

Oben steht das Codec-Dokument von EDTF-EVEN (0x06EL). Beim Codec-Dokument des anderen Mitglieds (EDTF-ODD) unterscheiden sich nur die Codec ID im DOC-ID, das DECLARE-Ziel und der in #1 gebundene Name (BIND).