EDTF é o Value que guarda, como cadeia de datas estendidas da ISO 8601-2, datas com precisão de ano ou mês, a.C., incertas ou em intervalo (Codec 0x06EL/0x06FL).

ItemValor
NomeEDTF (grupo par/ímpar. Os nomes por código estão na tabela de membros abaixo)
TAG ID0x06EL·0x06FL
Seção3 0011 (Value), deslocamento C na seção = 14~15
KindValue · família: TIME
Descrição no índicecadeia de data EDTF (ISO 8601-2). Bytes pares e ímpares. Não se usa para datas que podem ser escritas com GREGORIAN-DATE
Lado Hugovalue/time/edtf.md

Membros

Esta página trata em conjunto dois códigos de um par par/ímpar. O código par é o do valor com número par de bytes e o código ímpar é o do valor com número ímpar (Registro e TAG WORD). Há um documento de Codec por código. Os campos dos dois documentos de Codec são iguais e só diferem o alvo do DECLARE e o nome (BIND).

TAG IDNomeNúmero de bytesCodec IDDocumento de especificaçãoTAG WORD
0x06ELEDTF-EVENpar0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDímpar0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 LLLL

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato recebido (CODEC)ENUM
1bytes#2valor bruto restante (0xFFFF)

EDTF é o Value que guarda uma data como cadeia do Extended Date/Time Format (Biblioteca do Congresso dos EUA, ISO 8601-2:2019). Representa precisão mais grosseira que o dia, a.C., incerteza, aproximação, partes desconhecidas e intervalos.

Layout

  • Código: direct code de Value 0x06EL (bytes pares) e 0x06FL (bytes ímpares). Família TIME. O Payload é uma cadeia de caracteres, mas fica na família TIME.
  • O número de bytes é determinado pelo bit menos significativo do Codec e pelo número de WORD do Payload. É 2 × número de WORD do Payload − bit menos significativo, e não há Byte Count (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = bytes ímpares)
[TAG de extensão de Length] quando o total é de 15 WORD ou mais
Payload WORD 1st ... Nth          bytes ASCII da cadeia EDTF / se ímpar, o último 0x00

Interpretação e validade

  • A sequência de bytes é uma cadeia ASCII que segue a gramática EDTF dos Levels 0, 1 e 2. Uma cadeia vazia é invalid.
  • Exemplos: dia 1952-03-11, mês 1952-03, ano 1952, década 195X, 44 a.C. -0043, incerta 1974?, aproximada ~1974, intervalo 1952/2001, ano grande Y-13799999999.
  • Os anos seguem a forma astronômica da ISO 8601. 0000 é 1 a.C. e -0043 é 44 a.C. Ao transpor de uma notação histórica, desloca-se um ano.
  • É o calendário gregoriano. O EDTF não trata outros calendários. A notação original de outros calendários, como o juliano, é preservada em GEDCOM-DATE. O valor que transpõe esse mesmo dia ou período para o calendário gregoriano pode ser escrito em EDTF ou em GREGORIAN-DATE.
  • Forma canônica: uma data que pode ser escrita exatamente com GREGORIAN-DATE, isto é, [-]YYYY-MM-DD sem qualificadores (?, ~, %), sem dígitos desconhecidos (X), sem intervalo e sem prefixo Y, escreve-se com GREGORIAN-DATE. Escrever uma data assim em EDTF é invalid. Só se pode indexar e comparar como tempo se o mesmo dia estiver escrito em um único formato.
  • O schema ainda não verifica a gramática EDTF. O produtor verifica com um parser EDTF. Exemplo: parser.ParseString de github.com/sfomuseum/go-edtf (BSD-3-Clause). Não se usa parser.IsValid, pois olha apenas a gramática e deixa passar 2023-02-29 e 1974-13. Esse parser ainda não suporta anos com prefixo Y.

Comprimento

  • O total é o número de WORD somando 1 WORD de TAG, o TAG de extensão de Length (se houver) e o Payload (Length).

Exemplo

DataBytesWORD totais
19744 (par)06E2 3139 3734
197X4 (par)06E2 3139 3758
1952-037 (ímpar)06F4 3139 3532 2D30 3300

Base normativa

Problemas em aberto

  • Verificação da gramática EDTF pelo verificador (se o verificador dependerá de uma biblioteca externa).
  • Regra para transpor as precisões de século e milênio do Wikidata para dígitos desconhecidos do EDTF.

Páginas relacionadas

Texto original do documento de especificação

É o documento de especificação 0x00000000/codecs/0x000006E0/latest.geul lido com geul show (hexadecimal em maiúsculas).

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

O acima é o documento de Codec de EDTF-EVEN (0x06EL). O documento de Codec do outro membro (EDTF-ODD) só difere no Codec ID do DOC-ID, no alvo do DECLARE e no nome (BIND) ligado em #1.