GEDCOM-DATE é o Value que preserva, como cadeia de valor de data GEDCOM 7, datas de outros calendários, como o juliano, tal como foram escritas (Codec 0x070L/0x071L).

ItemValor
NomeGEDCOM-DATE (grupo par/ímpar; os nomes por código estão na tabela de membros abaixo)
TAG ID0x070L·0x071L
Seção3 0011 (Value), deslocamento C dentro da seção = 16~17
KindValue · família: TIME
Descrição do índiceCadeia de valor de data GEDCOM 7. Preserva a notação original de outros calendários (juliano etc.). Bytes pares·ímpares
Lado Hugovalue/time/gedcom-date.md

Membros

Esta página trata em conjunto os dois códigos de um par par/ímpar. O código par é o de valores com número par de bytes, e o ímpar, o de valores 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; só diferem o alvo de DECLARE e o nome (BIND).

TAG IDNomeNúmero de bytesCodec IDDocumento de especificaçãoTAG WORD
0x070LGEDCOM-DATE-EVENpar0x000007000x00000000/codecs/0x00000700/0000 0111 0000 LLLL
0x071LGEDCOM-DATE-ODDímpar0x000007100x00000000/codecs/0x00000710/0000 0111 0001 LLLL

Campos (documento de especificação)

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

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

GEDCOM-DATE é o Value que contém a cadeia do valor de data (DateValue) do GEDCOM 7 (FamilySearch). Preserva tal como foi escrita uma data que a origem escreveu em um calendário que não é o gregoriano (juliano etc.).

Layout

  • Código: códigos diretos de Value 0x070L (número par de bytes) e 0x071L (número ímpar de bytes). Família TIME.
  • O número de bytes é determinado pelo bit menos significativo do Codec e pelo número de WORDs do Payload. É 2 × número de WORD do Payload − bit menos significativo, e não há Byte Count (Value).
TAG WORD          0000 0111 000P LLLL      Codec 0x070L/0x071L (P = número ímpar de bytes)
[TAG de extensão de Length] quando o total é de 15 WORD ou mais
Payload WORD 1st ... Nth          bytes ASCII da cadeia de data GEDCOM / se ímpar, 0x00 no final

Interpretação e validade

  • A sequência de bytes é uma cadeia ASCII que segue a gramática DateValue do GEDCOM 7. Uma cadeia vazia é invalid. O GEDCOM admite um DateValue vazio, mas, se não houver valor, não se escreve o registro.
  • Resumo da gramática: [calendário] [[dia] mês] ano [BCE]. Na frente podem ir ABT, CAL, EST (aproximado), BEF, AFT, BET … AND … (intervalo), FROM … TO … (período). O separador é um único espaço.
  • Calendários: GREGORIAN (padrão se omitido), JULIAN, FRENCH_R, HEBREW, tags de extensão. Os nomes dos meses são definidos por calendário (o juliano usa JAN…DEC, como o gregoriano).
  • O ano é histórico. Não existe o ano 0, e antes da era comum acrescenta-se BCE (44 BCE = 44 a.C.). Há um ano de diferença em relação ao estilo astronômico de EDTF e GREGORIAN-DATE.
  • O schema só confere a forma dos bytes: ASCII 0x20~0x7E, não vazio, sem espaços no início e no fim. A gramática e a existência real do dia são conferidas pelo produtor. Exemplo: gedcom.ParseDate de github.com/cacack/gedcom-go/v3 (MIT). O Validate dessa biblioteca só confere o dia no calendário gregoriano e deixa passar JULIAN 30 FEB 1100, e o ToGregorian não converte de fato a precisão de ano e mês. A verificação da existência da data e a normalização fazem-se à parte.
  • Onde se usa: as datas do calendário gregoriano escrevem-se com GREGORIAN-DATE ou EDTF. GEDCOM-DATE usa-se para datas de outro calendário cuja notação original deve ser preservada.

Uso junto com um valor normalizado

  • Para comparar e indexar a mesma data no eixo do tempo, é preciso um valor gregoriano. Na precisão de dia, a correspondência exata é o GREGORIAN-DATE do mesmo dia; na precisão de ano e mês, é o EDTF de intervalo gregoriano desse período (JULIAN 1300 → 1300-01-09/1301-01-08).
  • Ainda não se definiu como reunir, em dois Values, a notação original (GEDCOM-DATE) e o valor normalizado (problema em aberto).

Comprimento

  • O total é 1 WORD de TAG mais o número de WORDs da TAG de extensão de Length (se houver) e do Payload (Length).

Exemplo

DataBytesWORDs no total
JULIAN 130011 (ímpar)0716 4A55 4C49 414E 2031 3330 3000

Base normativa

  • FamilySearch GEDCOM 7, Data types — Date, Appendix A: Calendars and Dates. A licença do repositório da especificação é Apache 2.0. GEUL apenas faz referência ao formato e não transcreve o texto da especificação.
  • ISO 8601, EDTF, XSD e os identificadores de calendário do CLDR (u-ca) não incluem o calendário juliano. GEDCOM 7 é um formato público de intercâmbio que trata, numa só gramática, prefixo de calendário, era anterior à comum, precisão e qualificadores.

Problemas em aberto

  • Como escrever juntos a notação original e o valor normalizado (como ligar os dois em um TRIPLE).
  • Verificação da gramática GEDCOM no schema.
  • Precisão de século e de década. O GEDCOM não tem formato para elas. Datas que não podem ser transpostas do Wikidata ficam como texto original em UTF8-TEXT.

Páginas relacionadas

Texto original do documento de especificação

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000070000000000
BODY
#1 DECLARE 0x0700
#2 FIELD #1 rest
#3 BIND #1 "GEDCOM-DATE-EVEN"
#4 BIND #2 "bytes"

Acima está o documento de Codec de GEDCOM-DATE-EVEN (0x070L). O documento de Codec do outro membro (GEDCOM-DATE-ODD) difere apenas no Codec ID do DOC-ID, no alvo de DECLARE e no nome ligado a #1 (BIND).