פריטערך
שםCIVIL-TIME-NANOSECONDS (מסמך מפרט BIND CIVIL-TIME-NANOSECONDS)
TAG ID0x06BL
Codec ID0x000006B0
מסמך מפרט0x00000000/codecs/0x000006B0/ (יעד DECLARE 06B0)
קטע3 0011 (Value), היסט בתוך הקטע C = 11
KindValue · משפחה: TIME
TAG WORD0000 0110 1011 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסמניין unsigned של nanosecond מאז חצות של יום אזרחי
בצד Hugovalue/time/civil-time-nanoseconds.md

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

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

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

CIVIL-TIME-NANOSECONDS מייצג שעה אזרחית ללא תאריך כמספר nanosecond מאז חצות.

פריסה

  • קוד: קוד ישיר של Value 0x06BL. משפחה TIME.
  • נעשה שימוש בטיפוס פיזי signed int64 ברוחב קבוע, כמו TIME(isAdjustedToUTC=false, unit=NANOS) של Parquet.
TAG WORD          0x06B4 (0000 0110 1011 0100)  סך הכול 5 WORD
Payload WORD 1st (bits 63..48)     Signed Nanoseconds high 16bit
Payload WORD 2nd (bits 47..32)     Signed Nanoseconds
Payload WORD 3rd (bits 31..16)     Signed Nanoseconds
Payload WORD 4th (bits 15..0)      Signed Nanoseconds low 16bit

פירוש ותוקף

  • ארבעת ה-WORD של ה-Payload נקראים כולם כמניין signed בן 64 סיביות בשיטת המשלים ל-2, בסדר WORD של big-endian.
  • הטיפוס הפיזי הוא signed int64, אך הטווח התקף הוא 0 <= value < 86,400×10^9ns. ערך שלילי וערך השווה לגבול העליון או גדול ממנו נדחים.
  • 24:00 ותווית שניית מעבר (leap second) אינם מותרים. גם תאריך, אזור זמן והיסט UTC אינם נשמרים.
  • גם ערך קטן תמיד נכתב ב-4 WORD.

אורך

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

דוגמה

  • חצות היא Payload 0000 0000 0000 0000, סך הכול 5 WORD, LLLL=0100.
  • 1ns אחרי חצות הוא Payload 0000 0000 0000 0001.
  • 86,400×10^9ns שווה לגבול העליון, ולכן אינו תקף.
  • FFFF FFFF FFFF FFFF הוא -1 כ-signed int64, ולכן אינו תקף.

בסיס תקני

  • TIME(isAdjustedToUTC=false, unit=NANOS) ב-Apache Parquet Logical Types שומר nanosecond מאז חצות של local time ב-int64, ובעל סדר signed.
  • לפי Apache Arrow Columnar Format ו-Schema.fbs הסמכותי, Time ברזולוציית NANOSECOND מוגדר כמספר שלם signed בן 64 סיביות, הטווח התקף מוגבל לפחות מ-86,400 שניות כולל חצות, ואינו מתיר שניית מעבר. GEUL מוסיף רק TAG ומסגור WORD של 16 סיביות big-endian.

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

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006B000000000
BODY
#1 DECLARE 0x06B0
#2 FIELD #1 0x0004
#3 BIND #1 "CIVIL-TIME-NANOSECONDS"
#4 BIND #2 "nanoseconds"