GEDCOM-DATE は GEDCOM 7 の日付値文字列で、ユリウス暦など他の暦の日付を記された表記のまま保存する Value である(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 は GEDCOM 7(FamilySearch)の日付値(DateValue)文字列を収める Value である。原本がグレゴリオ暦以外の暦(ユリウス暦など)で記した日付を記されたまま保存する。
レイアウト
- コード: 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 GEDCOM 日付文字列の ASCII バイト / 奇数なら最後に 0x00
解釈と有効性
- バイト列は GEDCOM 7
DateValueの文法に従う ASCII 文字列である。空文字列は invalid である。GEDCOM は空のDateValueを許すが、値がなければレコードを書かない。 - 文法の要点:
[暦] [[日] 月] 年 [BCE]。先頭にABT·CAL·EST(おおよそ)、BEF·AFT·BET … AND …(範囲)、FROM … TO …(期間)を付ける。区切りは空白一つである。 - 暦:
GREGORIAN(省略時の既定)、JULIAN、FRENCH_R、HEBREW、拡張タグ。月名は暦ごとに定まっている(ユリウス暦はグレゴリオ暦と同じJAN…DEC)。 - 年は歴史式である。0 年がなく、紀元前は
BCEを付ける(44 BCE= 紀元前 44 年)。EDTF·GREGORIAN-DATE の天文式とは 1 年の差が出る。 - schema はバイト形式だけを検査する: ASCII
0x20~0x7E、空でないこと、前後に空白がないこと。文法と実在する日かどうかは生産者が検査する。例:github.com/cacack/gedcom-go/v3(MIT)のgedcom.ParseDate。このライブラリの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 として併せて収める方法はまだ決めていない(未解決の問題)。
長さ
- 全体は TAG 1 WORD、Length 拡張 TAG(あれば)と Payload を合わせた WORD 数である(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 に両者をつなぐ方法)。
- schema の GEDCOM 文法検査。
- 世紀·10 年精度。GEDCOM にはそのような形式がない。Wikidata から移せない日付は原文を UTF8-TEXT に残す。
関連ページ
規格ドキュメント原文
規格ドキュメント 0x00000000/codecs/0x00000700/latest.geul を geul show で読んだ様子である(16 進は大文字)。
SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000070000000000
BODY
#1 DECLARE 0x0700
#2 FIELD #1 rest
#3 BIND #1 "GEDCOM-DATE-EVEN"
#4 BIND #2 "bytes"
上は GEDCOM-DATE-EVEN(0x070L)の Codec ドキュメントである。他の構成員(GEDCOM-DATE-ODD)の Codec ドキュメントは、DOC-ID の Codec ID、DECLARE の対象、#1 に結び付けた名前(BIND)だけが異なる。