EDTF es el Value que contiene fechas como precisión de año o mes, antes de nuestra era, incertidumbre e intervalos, mediante cadenas de fecha extendidas de ISO 8601-2 (Codec 0x06EL/0x06FL).

ElementoValor
NombreEDTF (grupo par/impar. El nombre de cada código está en la tabla de miembros de abajo)
TAG ID0x06EL·0x06FL
Sección3 0011 (Value), desplazamiento C dentro de la sección = 14~15
KindValue · familia: TIME
Descripción del índicecadena de fecha EDTF (ISO 8601-2). Bytes pares e impares. No se usa para fechas que se puedan escribir con GREGORIAN-DATE
Lado Hugovalue/time/edtf.md

Miembros

Esta página trata juntos los dos códigos de un par par/impar. El código par es el de valores con un número par de bytes y el código impar, el de valores con un número impar (registro y TAG WORD). Hay un documento de Codec por cada código. Los campos de los dos documentos de Codec son iguales y solo difieren el destino de DECLARE y el nombre (BIND).

TAG IDNombreNúmero de bytesCodec IDDocumento de especificaciónTAG WORD
0x06ELEDTF-EVENpar0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDimpar0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 LLLL

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato receptor (CODEC)ENUM
1bytes#2resto en bruto (0xFFFF)

EDTF es el Value que contiene fechas mediante cadenas de Extended Date/Time Format (Biblioteca del Congreso de EE. UU., ISO 8601-2:2019). Representa precisiones más gruesas que el día, fechas antes de nuestra era, lo incierto, aproximado o parcialmente desconocido, e intervalos.

Layout

  • Código: código directo de Value 0x06EL (bytes pares) y 0x06FL (bytes impares). Familia TIME. El Payload es una cadena, pero se coloca en la familia TIME.
  • El número de bytes se determina por el bit menos significativo del Codec y por el número de WORD del Payload. Es 2 × número de WORD del Payload − bit menos significativo, y no hay Byte Count (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = bytes impares)
[TAG de extensión de Length] cuando el total es de 15 WORD o más
Payload WORD 1st ... Nth          bytes ASCII de la cadena EDTF / si es impar, el último 0x00

Interpretación y validez

  • La secuencia de bytes es una cadena ASCII que sigue la gramática EDTF de Level 0·1·2. Una cadena vacía es invalid.
  • Ejemplos: día 1952-03-11, mes 1952-03, año 1952, década 195X, 44 a. C. -0043, incierto 1974?, aproximado ~1974, intervalo 1952/2001, año grande Y-13799999999.
  • Los años siguen el sistema astronómico de ISO 8601. 0000 es el 1 a. C. y -0043 es el 44 a. C. Al trasladar desde la notación histórica, se desplaza un año.
  • Es el calendario gregoriano. EDTF no trata otros calendarios. La notación original de otros calendarios, como el juliano, se conserva con GEDCOM-DATE. El valor de ese día o período trasladado al calendario gregoriano se puede escribir con EDTF o GREGORIAN-DATE.
  • Forma canónica: una fecha que se pueda escribir exactamente con GREGORIAN-DATE, es decir, [-]YYYY-MM-DD sin calificadores (?, ~, %), sin dígitos desconocidos (X), sin intervalo y sin prefijo Y, se escribe con GREGORIAN-DATE. Escribir una fecha así con EDTF es invalid. Solo si un mismo día se escribe en un único formato se puede indexar y comparar como tiempo.
  • El schema todavía no comprueba la gramática EDTF. El productor la comprueba con un analizador de EDTF. Ejemplo: parser.ParseString de github.com/sfomuseum/go-edtf (BSD-3-Clause). parser.IsValid solo mira la gramática y deja pasar también 2023-02-29 y 1974-13, por lo que no se usa. Este analizador aún no admite los años con prefijo Y.

Longitud

  • El total es el número de WORD que suman el TAG de 1 WORD, el TAG de extensión de Length (si lo hay) y el Payload (Length).

Ejemplo

FechaBytesWORD totales
19744 (par)06E2 3139 3734
197X4 (par)06E2 3139 3758
1952-037 (impar)06F4 3139 3532 2D30 3300

Fundamento normativo

Problemas abiertos

  • La comprobación de la gramática EDTF en el validador (si el validador se apoyará en una biblioteca externa).
  • La regla para trasladar las precisiones de siglo y milenio de Wikidata a los dígitos desconocidos de EDTF.

Páginas relacionadas

Texto original del documento de especificación

Es el aspecto del documento de especificación 0x00000000/codecs/0x000006E0/latest.geul leído con geul show (hexadecimal en mayúsculas).

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

Lo anterior es el documento de Codec de EDTF-EVEN (0x06EL). El documento de Codec del otro miembro (EDTF-ODD) solo difiere en el Codec ID del DOC-ID, el destino de DECLARE y el nombre (BIND) asociado a #1.