פריטערך
שםDURATION-SECONDS (מסמך מפרט BIND DURATION-SECONDS)
TAG ID0x06DL
Codec ID0x000006D0
מסמך מפרט0x00000000/codecs/0x000006D0/ (יעד DECLARE 06D0)
קטע3 0011 (Value), היסט בתוך הקטע C = 13
KindValue · משפחה: TIME
TAG WORD0000 0110 1101 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסזמן שחלף ב-SI-second עם סימן, ללא epoch
בצד Hugovalue/time/duration-seconds.md

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

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

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

DURATION-SECONDS הוא זמן שחלף ביחידות שניות signed, ללא epoch. הוא אינו instant ואינו משך בחודשים או בשנים של לוח השנה.

פריסה

  • קוד: קוד ישיר של Value 0x06DL. משפחה TIME.
  • נעשה שימוש בטיפוס פיזי signed int64 ברוחב קבוע, כמו Duration(SECOND) של Arrow.
TAG WORD          0x06D4 (0000 0110 1101 0100)  סך הכול 5 WORD
Payload WORD 1st (bits 63..48)     Signed Seconds high 16bit
Payload WORD 2nd (bits 47..32)     Signed Seconds
Payload WORD 3rd (bits 31..16)     Signed Seconds
Payload WORD 4th (bits 15..0)      Signed Seconds low 16bit

פירוש ותוקף

  • ארבעת ה-WORD של ה-Payload נקראים כולם כמניין signed בן 64 סיביות בשיטת המשלים ל-2, בסדר WORD של big-endian.
  • הטווח התקף הוא -2^63~2^63-1 שניות. הסימן הוא כיוון הזמן שחלף, ואינו מצביע על instant של epoch מסוים.
  • גם ערך קטן תמיד נכתב ב-4 WORD.

אורך

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

דוגמה

  • 0 שניות הוא Payload 0000 0000 0000 0000, סך הכול 5 WORD, LLLL=0100.
  • שנייה אחת היא Payload 0000 0000 0000 0001.
  • -1 שנייה היא Payload FFFF FFFF FFFF FFFF.

בסיס תקני

  • Apache Arrow Columnar Format קובע את Schema.fbs כמקור הסמכותי לטיפוסי הנתונים הסטנדרטיים של Arrow.
  • ב-Schema.fbs הסמכותי של Arrow, Duration הוא זמן שחלף מוחלט שאינו תלוי בלוח שנה, תומך ביחידת SECOND ומיוצג תמיד כמספר שלם signed בן 8 בתים. GEUL מוסיף לכך רק TAG ומסגור WORD של 16 סיביות big-endian.

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

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006D000000000
BODY
#1 DECLARE 0x06D0
#2 FIELD #1 0x0004
#3 BIND #1 "DURATION-SECONDS"
#4 BIND #2 "seconds"