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). 코덱 문서는 코드마다 하나다. 두 코덱 문서의 필드는 같고 DECLARE 대상과 이름(BIND)만 다르다.

TAG ID이름바이트 수코덱 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

표준 근거

  • 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에는 해당 형식이 없다. 위키데이터에서 옮기지 못하는 날짜는 원문을 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)의 코덱 문서다. 다른 구성원(GEDCOM-DATE-ODD)의 코덱 문서는 DOC-ID의 코덱 ID, DECLARE 대상, #1에 묶은 이름(BIND)만 다르다.