DURATION-NANOSECONDS هو زمن منقضٍ بالنانوثانية موقّع (signed) وبلا epoch. فليس instant ولا مدة بالأشهر أو السنوات التقويمية.

البندالقيمة
الاسمDURATION-NANOSECONDS (BIND في مستند المواصفة DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
مستند المواصفة0x00000000/codecs/0x00000810/ (هدف DECLARE 0810)
القسم4 0100 (Value)، الإزاحة C داخل القسم = 1
KindValue · العائلة: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسزمن منقضٍ بالنانوثانية موقّع وبلا epoch
جهة Hugovalue/time/duration-nanoseconds.md

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).

الترتيبالحقل (BIND)FIELDالعرضالصيغة المستقبِلة (CODEC)ENUM
1nanoseconds#2قيمة خام بـ 4 WORD

التخطيط

  • الرمز: رمز مباشر لـ Value هو 0x081L. العائلة TIME.
  • يستعمل النوع الفيزيائي نفسه الثابت العرض signed int64 كما في Arrow Duration(NANOSECOND).
TAG WORD          0x0814 (0000 1000 0001 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

التفسير والصلاحية

  • يُقرأ Payload بـ 4 WORD كله كعدد موقّع بتكميل الاثنين بطول 64 بت بترتيب WORD من نوع big-endian.
  • المدى الصالح هو -2^63~2^63-1 نانوثانية. والإشارة هي اتجاه الانقضاء، ولا تدل على instant في epoch معين.
  • تُستعمل 4 WORD دائماً حتى للقيم الصغيرة.

الطول

  • المجموع هو TAG بـ 1 WORD مع Payload بـ 4 WORD أي 5 WORD بالضبط، ويستعمل الطول المباشر LLLL=0100. لا TAG Length ممتد ولا descriptor ولا padding.
  • يُرفض إن لم يكن Payload 4 WORD بالضبط.

مثال

  • 0ns: Payload هو 0000 0000 0000 0000، والمجموع 5 WORD، وLLLL=0100. فالكل 0814 0000 0000 0000 0000.
  • 1ns: Payload هو 0000 0000 0000 0001.
  • -1ns: Payload هو FFFF FFFF FFFF FFFF.

المرجع المعياري

  • يحدد Apache Arrow Columnar Format أن Schema.fbs هو المصدر المرجعي (authoritative) لأنواع بيانات Arrow المعيارية.
  • في Schema.fbs المرجعي لـ Arrow، Duration زمن منقضٍ مطلق لا علاقة له بالتقويم، يدعم وحدة NANOSECOND، ويُمثَّل دائماً بعدد صحيح موقّع من 8 بايتات. ولا تضيف GEUL إليه سوى TAG وتأطير WORD ذي 16 بت بترتيب big-endian.

نص مستند المواصفة

هذا مستند المواصفة 0x00000000/codecs/0x00000810/latest.geul كما يُقرأ بـ geul show (الأرقام السداسية عشرية بأحرف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000081000000000
BODY
#1 DECLARE 0x0810
#2 FIELD #1 0x0004
#3 BIND #1 "DURATION-NANOSECONDS"
#4 BIND #2 "nanoseconds"