פריטערך
שםGREGORIAN-DATE (מסמך מפרט BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec ID0x000006A0
מסמך מפרט0x00000000/codecs/0x000006A0/ (יעד DECLARE 06A0)
קטע3 0011 (Value), היסט בתוך הקטע C = 10
KindValue · משפחה: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסמספר ימים signed ביחס ל-1970-01-01 בלוח הגרגוריאני הפרולפטי (proleptic Gregorian)
בצד Hugovalue/time/gregorian-date.md

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

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

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

GREGORIAN-DATE הוא מספר ימים signed שבו 1970-01-01 בלוח הגרגוריאני הפרולפטי (proleptic Gregorian) הוא day 0. אין בו אזור זמן ואין שעה ביום.

פריסה

  • קוד: קוד ישיר של Value 0x06AL. משפחה TIME.
  • נעשה שימוש בטיפוס פיזי signed int32 ברוחב קבוע, כמו Arrow Date32 ו-DATE של Parquet.
TAG WORD          0x06A2 (0000 0110 1010 0010)  סך הכול 3 WORD
Payload WORD 1st (bits 31..16)     Signed Day Count high 16bit
Payload WORD 2nd (bits 15..0)      Signed Day Count low 16bit

פירוש ותוקף

  • שני ה-WORD של ה-Payload נקראים כולם כ-day count signed בן 32 סיביות בשיטת המשלים ל-2, בסדר WORD של big-endian.
  • הטווח התקף הוא -2^31~2^31-1 ימים. ערך שלילי הוא תאריך לפני ה-epoch.
  • בחישוב חזרה מ-day count לשנה, חודש ויום משתמשים בלוח הגרגוריאני הפרולפטי, ללא מעברי לוח היסטוריים.
  • גם ערך קטן תמיד נכתב ב-2 WORD.

אורך

  • הסך הכול הוא בדיוק 3 WORD, TAG אחד ו-Payload של 2 WORD, ונעשה שימוש באורך הישיר LLLL=0010. אין TAG הרחבת Length, אין descriptor ואין padding.
  • אם ה-Payload אינו 2 WORD בדיוק, הוא נדחה.

דוגמה

תאריךPayloadLength כולל
1970-01-010000 00003 WORD (LLLL=0010)
1970-01-020000 00013 WORD (LLLL=0010)
1969-12-31FFFF FFFF3 WORD (LLLL=0010)

הקשר ל-EDTF

  • דיוק גס יותר מיום, אי-ודאות או קירוב, וטווחים נכתבים ב-EDTF. תאריך שאפשר לכתוב במדויק ב-GREGORIAN-DATE אינו נכתב ב-EDTF (הצורה הקנונית של EDTF).

בסיס תקני

  • DATE ב-Apache Parquet Logical Types הוא int32 השומר את מספר הימים מ-1970-01-01, ה-Unix epoch, ובעל סדר signed.
  • Date32 ב-Apache Arrow Columnar Format וב-Schema.fbs הסמכותי שומר את מספר הימים מה-Unix epoch כמספר שלם signed בן 32 סיביות.
  • החישוב החוזר בלוח הגרגוריאני הפרולפטי הוא calendar profile של GEUL שפורמט זה מאמץ. משמעות day-count ה-int32 של Arrow/Parquet נשארת כמות שהיא, ונוספים רק TAG ומסגור WORD של 16 סיביות big-endian.

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

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006A000000000
BODY
#1 DECLARE 0x06A0
#2 FIELD #1 0x0002
#3 BIND #1 "GREGORIAN-DATE"
#4 BIND #2 "days"