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).
| Item | Valor |
|---|---|
| Nome | EDTF (grupo par/ímpar. Os nomes por código estão na tabela de membros abaixo) |
| TAG ID | 0x06EL·0x06FL |
| Seção | 3 0011 (Value), deslocamento C na seção = 14~15 |
| Kind | Value · família: TIME |
| Descrição no índice | cadeia de data EDTF (ISO 8601-2). Bytes pares e ímpares. Não se usa para datas que podem ser escritas com GREGORIAN-DATE |
| Lado Hugo | value/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 ID | Nome | Número de bytes | Codec ID | Documento de especificação | TAG WORD |
|---|---|---|---|---|---|
0x06EL | EDTF-EVEN | par | 0x000006E0 | 0x00000000/codecs/0x000006E0/ | 0000 0110 1110 LLLL |
0x06FL | EDTF-ODD | ímpar | 0x000006F0 | 0x00000000/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).
| Ordem | Campo (BIND) | FIELD | Largura | Formato recebido (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | bytes | #2 | valor 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) e0x06FL(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ês1952-03, ano1952, década195X, 44 a.C.-0043, incerta1974?, aproximada~1974, intervalo1952/2001, ano grandeY-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-DDsem qualificadores (?,~,%), sem dígitos desconhecidos (X), sem intervalo e sem prefixoY, 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.ParseStringdegithub.com/sfomuseum/go-edtf(BSD-3-Clause). Não se usaparser.IsValid, pois olha apenas a gramática e deixa passar2023-02-29e1974-13. Esse parser ainda não suporta anos com prefixoY.
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
| Data | Bytes | WORD totais |
|---|---|---|
1974 | 4 (par) | 06E2 3139 3734 |
197X | 4 (par) | 06E2 3139 3758 |
1952-03 | 7 (ímpar) | 06F4 3139 3532 2D30 3300 |
Base normativa
- Library of Congress, Extended Date/Time Format (EDTF) Specification. O Level 0 é um subconjunto da ISO 8601-1 e os Levels 1 e 2 são recursos da ISO 8601-2.
- Em RDF, a mesma cadeia é indicada pelo tipo de dado
http://id.loc.gov/datatypes/edtf.
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.