GEDCOM-DATE — Value, хранящий строку значения даты GEDCOM 7 в исходной записи, в том числе даты по другим календарям, например юлианскому (Codec 0x070L/0x071L).

ПунктЗначение
ИмяGEDCOM-DATE (группа «чётный/нечётный». Имена по кодам — в таблице участников ниже)
TAG ID0x070L·0x071L
Раздел3 0011 (Value), смещение C внутри раздела = 16~17
KindValue · семейство: TIME
Описание в индексеСтрока значения даты GEDCOM 7. Сохраняет исходную запись дат по другим календарям (юлианскому и др.). Чётное и нечётное число байтов
Сторона Hugovalue/time/gedcom-date.md

Участники

Эта страница охватывает пару кодов «чётный/нечётный». У чётного кода число байтов чётное, у нечётного — нечётное (запись и TAG WORD). Документ Codec заведён на каждый код. Поля в двух документах Codec совпадают, различаются только цель DECLARE и имя (BIND).

TAG IDИмяЧисло байтовCodec IDДокумент спецификацииTAG WORD
0x070LGEDCOM-DATE-EVENчётное0x000007000x00000000/codecs/0x00000700/0000 0111 0000 LLLL
0x071LGEDCOM-DATE-ODDнечётное0x000007100x00000000/codecs/0x00000710/0000 0111 0001 LLLL

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1bytes#2остаток, простое значение (0xFFFF)

GEDCOM-DATE — Value, содержащий строку значения даты (DateValue) из GEDCOM 7 (FamilySearch). Дату, которую источник записал по негригорианскому календарю (юлианскому и т. п.), он сохраняет в том виде, как она записана.

Раскладка

  • Код: прямой код Value 0x070L (чётное число байтов) и 0x071L (нечётное число байтов). Семейство TIME.
  • Число байтов определяется младшим битом Codec и числом Payload WORD: 2 × число Payload WORD − младший бит. Byte Count не вводится (Value).
TAG WORD          0000 0111 000P LLLL      Codec 0x070L/0x071L (P = нечётное число байтов)
[расширяющий Length TAG] если всего 15 WORD и более
Payload WORD 1st ... Nth          ASCII-байты строки даты GEDCOM / при нечётном числе последний 0x00

Интерпретация и действительность

  • Последовательность байтов — это ASCII-строка по грамматике GEDCOM 7 DateValue. Пустая строка недействительна (invalid). GEDCOM допускает пустой DateValue, но если значения нет, запись не пишется.
  • Суть грамматики: [календарь] [[день] месяц] год [BCE]. Спереди могут стоять ABT, CAL, EST (приблизительно), BEF, AFT, BET … AND … (диапазон), FROM … TO … (период). Разделитель — один пробел.
  • Календари: GREGORIAN (по умолчанию, если опущен), JULIAN, FRENCH_R, HEBREW, расширенные теги. Названия месяцев определены для каждого календаря (в юлианском те же JAN…DEC, что и в григорианском).
  • Годы — исторической системы. Нулевого года нет, а до н. э. помечается BCE (44 BCE = 44 год до н. э.). Это на год отличается от астрономической системы EDTF и GREGORIAN-DATE.
  • schema проверяет только байтовый формат: ASCII 0x20~0x7E, непустая строка, без пробелов в начале и в конце. Грамматику и реальное существование дня проверяет производитель. Пример: gedcom.ParseDate из github.com/cacack/gedcom-go/v3 (MIT). Validate этой библиотеки проверяет день только в григорианском календаре и потому пропускает JULIAN 30 FEB 1100, а ToGregorian не выполняет настоящего перевода для точности до года и месяца. Проверка существования даты и нормализация выполняются отдельно.
  • Где применяется: григорианские даты записываются как GREGORIAN-DATE или EDTF. GEDCOM-DATE применяется для дат по другим календарям, у которых нужно сохранить исходную запись.

Совместное использование с нормализованным значением

  • Чтобы сравнивать и индексировать ту же дату на оси времени, нужно григорианское значение. Для точности до дня точное соответствие — GREGORIAN-DATE того же дня, для точности до года и месяца — EDTF-интервал этого периода по григорианскому календарю (JULIAN 1300 → 1300-01-09/1301-01-08).
  • Как хранить исходную запись (GEDCOM-DATE) и нормализованное значение вместе в двух Value, пока не определено (открытая проблема).

Длина

  • Всего — число WORD: 1 WORD TAG, расширяющий Length TAG (если есть) и Payload (Length).

Пример

ДатаБайтыВсего WORD
JULIAN 130011 (нечётное)0716 4A55 4C49 414E 2031 3330 3000

Основание в стандартах

  • FamilySearch GEDCOM 7, Data types — Date, Appendix A: Calendars and Dates. Лицензия репозитория спецификации — Apache 2.0. GEUL лишь ссылается на формат и не переносит текст спецификации.
  • В ISO 8601, EDTF, XSD, идентификаторах календарей CLDR (u-ca) юлианского календаря нет. GEDCOM 7 — открытый формат обмена, описывающий префикс календаря, до н. э., точность и квалификаторы одной грамматикой.

Открытые проблемы

  • Способ совместной записи исходной записи и нормализованного значения (как связать их в одном TRIPLE).
  • Проверка грамматики GEDCOM в schema.
  • Точность до века и десятилетия. В GEDCOM такого формата нет. Даты, которые нельзя перенести из Викиданных, остаются исходным текстом в UTF8-TEXT.

Связанные страницы

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x00000700/latest.geul, прочитанный командой geul show (шестнадцатеричные цифры заглавные).

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

Выше — документ Codec для GEDCOM-DATE-EVEN (0x070L). В документах Codec других участников (GEDCOM-DATE-ODD) различаются только Codec ID в DOC-ID, цель DECLARE и имя, привязанное в #1 (BIND).