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 העוקבת אחר דקדוק
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 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 אין פורמט כזה. תאריך שאי אפשר להעביר מ-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).