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 העוקבת אחר דקדוק DateValue של GEDCOM 7. מחרוזת ריקה היא 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, לא ריק, ללא רווחים בתחילה ובסוף. הדקדוק וקיומו של היום בפועל נבדקים על ידי היצרן. לדוגמה: 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 של 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 אין פורמט כזה. תאריך שאי אפשר להעביר מ-Wikidata נשמר כטקסט מקור ב-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).