EDTF הוא Value המכיל תאריך כמחרוזת תאריך מורחבת של ISO 8601-2, לרבות דיוק של שנה וחודש, לפני הספירה, אי-ודאות וטווח (Codec 0x06EL/0x06FL).

פריטערך
שםEDTF (קבוצה זוגית-אי-זוגית. השם של כל קוד בטבלת החברים שלהלן)
TAG ID0x06EL·0x06FL
קטע3 0011 (Value), היסט בתוך הקטע C = 14~15
KindValue · משפחה: TIME
תיאור באינדקסמחרוזת תאריך EDTF (ISO 8601-2). בתים זוגיים ואי-זוגיים. תאריך שאפשר לכתוב ב-GREGORIAN-DATE אינו נכתב כאן
בצד Hugovalue/time/edtf.md

חברים

דף זה עוסק בשני קודים של זוג זוגי-אי-זוגי. קוד זוגי הוא ערך שמספר הבתים שלו זוגי, וקוד אי-זוגי הוא ערך שמספר הבתים שלו אי-זוגי (רשומה ו-TAG WORD). מסמך ה-Codec הוא אחד לכל קוד. השדות בשני מסמכי ה-Codec זהים, ורק יעד ה-DECLARE והשם (BIND) שונים.

TAG IDשםמספר בתיםCodec IDמסמך מפרטTAG WORD
0x06ELEDTF-EVENזוגי0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDאי-זוגי0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 LLLL

שדות (מסמך מפרט)

סדר ה-FIELD במסמך הוא סדר שדות ה-Payload (מסמך המפרט של Codec).

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1bytes#2ערך גולמי, השאר (0xFFFF)

EDTF הוא Value המכיל תאריך כמחרוזת של Extended Date/Time Format (ספריית הקונגרס של ארה"ב, ISO 8601-2:2019). הוא מייצג דיוק גס מיום, לפני הספירה, אי-ודאות, קירוב או אי-ידיעה חלקית, וטווחים.

פריסה

  • קוד: קוד ישיר של Value 0x06EL (בתים זוגיים) ו-0x06FL (בתים אי-זוגיים). משפחה TIME. ה-Payload הוא מחרוזת, אך הוא ממוקם במשפחת TIME.
  • מספר הבתים נקבע לפי הסיבית הנמוכה ביותר של ה-Codec ומספר ה-WORD של ה-Payload. הוא 2 × מספר WORD של ה-Payload − הסיבית הנמוכה ביותר, ואין Byte Count (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = בתים אי-זוגיים)
[TAG הרחבת Length] כאשר הסך הכול 15 WORD ומעלה
Payload WORD 1st ... Nth          בתי ASCII של מחרוזת EDTF / אם אי-זוגי, בסוף 0x00

פירוש ותוקף

  • רצף הבתים הוא מחרוזת ASCII העוקבת אחר התחביר של EDTF ברמות 0, 1 ו-2. מחרוזת ריקה היא invalid.
  • דוגמאות: יום 1952-03-11, חודש 1952-03, שנה 1952, עשור 195X, 44 לפני הספירה -0043, לא ודאי 1974?, משוער ~1974, טווח 1952/2001, שנה גדולה Y-13799999999.
  • השנה היא לפי ISO 8601 האסטרונומי. 0000 היא שנת 1 לפני הספירה, ו--0043 היא שנת 44 לפני הספירה. בהעברה מרישום היסטורי מזיזים שנה אחת.
  • הלוח הוא הגרגוריאני. EDTF אינו עוסק בלוחות אחרים. רישום מקורי של לוח אחר, כגון הלוח היוליאני, נשמר ב-GEDCOM-DATE. ערך המציין את אותו יום או את אותה תקופה בלוח הגרגוריאני אפשר לכתוב ב-EDTF או ב-GREGORIAN-DATE.
  • צורה קנונית: תאריך שאפשר לכתוב במדויק ב-GREGORIAN-DATE, כלומר [-]YYYY-MM-DD ללא מסייג (?, ~, %), ללא ספרות לא ידועות (X), ללא טווח וללא תחילית Y, נכתב ב-GREGORIAN-DATE. כתיבת תאריך כזה ב-EDTF היא invalid. רק כאשר אותו יום נרשם בפורמט אחד בלבד אפשר לאנדקס ולהשוות לפי זמן.
  • ה-schema עדיין אינו בודק את התחביר של EDTF. היצרן בודק באמצעות מנתח EDTF. לדוגמה parser.ParseString של github.com/sfomuseum/go-edtf (BSD-3-Clause). אין להשתמש ב-parser.IsValid, כי הוא בודק רק תחביר ומעביר גם 2023-02-29 ו-1974-13. מנתח זה עדיין אינו תומך בשנה עם תחילית Y.

אורך

  • הסך הכול הוא מספר ה-WORD של TAG אחד, TAG הרחבת Length (אם יש) ו-Payload (Length).

דוגמה

תאריךבתיםסך הכול WORD
19744 (זוגי)06E2 3139 3734
197X4 (זוגי)06E2 3139 3758
1952-037 (אי-זוגי)06F4 3139 3532 2D30 3300

בסיס תקני

בעיות פתוחות

  • בדיקת התחביר של EDTF בבודק (האם הבודק יסתמך על ספרייה חיצונית).
  • כלל להעברת דיוק של מאה ואלף שנים בוויקינתונים לספרות לא ידועות ב-EDTF.

דפים קשורים

הטקסט המקורי של מסמך המפרט

זהו מסמך המפרט 0x00000000/codecs/0x000006E0/latest.geul כפי שהוא נקרא באמצעות geul show (ספרות הקסדצימליות באותיות גדולות).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006E000000000
BODY
#1 DECLARE 0x06E0
#2 FIELD #1 rest
#3 BIND #1 "EDTF-EVEN"
#4 BIND #2 "bytes"

האמור לעיל הוא מסמך ה-Codec של EDTF-EVEN (0x06EL). במסמך ה-Codec של החבר האחר (EDTF-ODD) שונים רק ה-Codec ID שב-DOC-ID, יעד ה-DECLARE והשם שנקשר ב-#1 (BIND).