GEDCOM-DATE — Value, хранящий строку значения даты GEDCOM 7 в исходной записи, в том числе даты по другим календарям, например юлианскому (Codec 0x070L/0x071L).
| Пункт | Значение |
|---|---|
| Имя | GEDCOM-DATE (группа «чётный/нечётный». Имена по кодам — в таблице участников ниже) |
| TAG ID | 0x070L·0x071L |
| Раздел | 3 0011 (Value), смещение C внутри раздела = 16~17 |
| Kind | Value · семейство: TIME |
| Описание в индексе | Строка значения даты GEDCOM 7. Сохраняет исходную запись дат по другим календарям (юлианскому и др.). Чётное и нечётное число байтов |
| Сторона Hugo | value/time/gedcom-date.md |
Участники
Эта страница охватывает пару кодов «чётный/нечётный». У чётного кода число байтов чётное, у нечётного — нечётное (запись и TAG WORD). Документ Codec заведён на каждый код. Поля в двух документах Codec совпадают, различаются только цель DECLARE и имя (BIND).
| TAG ID | Имя | Число байтов | Codec ID | Документ спецификации | TAG WORD |
|---|---|---|---|---|---|
0x070L | GEDCOM-DATE-EVEN | чётное | 0x00000700 | 0x00000000/codecs/0x00000700/ | 0000 0111 0000 LLLL |
0x071L | GEDCOM-DATE-ODD | нечётное | 0x00000710 | 0x00000000/codecs/0x00000710/ | 0000 0111 0001 LLLL |
Поля (документ спецификации)
Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | bytes | #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 1300 | 11 (нечётное) | 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).