GEDCOM-DATE 是 GEDCOM 7 日期值字符串,按书写原样保存儒略历等其他历法的日期的 Value(Codec 0x070L/0x071L)。

项目值
名称GEDCOM-DATE(奇偶分组。各代码的名称见下方成员表)
TAG ID0x070L·0x071L
章节3 0011(Value),章节内偏移 C = 16~17
KindValue · 系列:TIME
索引说明GEDCOM 7 日期值字符串。保存其他历法(儒略历等)的原始写法。偶数·奇数字节
Hugo 路径value/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 是承载 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 的天文式相差一年。
  • 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 130011(奇数)0716 4A55 4C49 414E 2031 3330 3000

标准依据

未决问题

  • 同时书写原始写法与规范化值的方法(在一个 TRIPLE 中把两者连起来的方法)。
  • schema 对 GEDCOM 语法的检查。
  • 世纪·十年精度。GEDCOM 没有对应格式。无法从 Wikidata 转入的日期,其原文保留为 UTF8-TEXT。

相关页面

规格文档原文

这是用 geul show 读取规格文档 0x00000000/codecs/0x00000700/latest.geul 的样子(十六进制为大写)。

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)上不同。