DURATION-NANOSECONDS ist eine vorzeichenbehaftete Zeitspanne in Nanosekunden ohne Epoche. Sie ist weder ein Instant noch eine Kalenderspanne in Monaten oder Jahren.

EintragWert
NameDURATION-NANOSECONDS (BIND im Spezifikationsdokument DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
Spezifikationsdokument0x00000000/codecs/0x00000810/ (DECLARE-Ziel 0810)
Abschnitt4 0100 (Value), Offset im Abschnitt C = 1
KindValue · Familie: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
IndexbeschreibungVorzeichenbehaftete Zeitspanne in Nanosekunden ohne Epoche
Hugo-Pfadvalue/time/duration-nanoseconds.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELDs im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1nanoseconds#2Rohwert 4 WORDs

Layout

  • Code: direkter Value-Code 0x081L. Familie TIME.
  • Verwendet wird derselbe physische Typ fester Breite wie bei Arrow Duration(NANOSECOND), ein signed int64.
TAG WORD          0x0814 (0000 1000 0001 0100)  insgesamt 5 WORDs
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

Interpretation und Gültigkeit

  • Alle 4 Payload-WORDs werden als 64-Bit-Zweierkomplement-Zähler mit Vorzeichen in Big-Endian-WORD-Reihenfolge gelesen.
  • Der gültige Bereich ist -2^63~2^63-1 ns. Das Vorzeichen ist die Richtung der Zeitspanne und verweist nicht auf einen Instant einer bestimmten Epoche.
  • Auch kleine Werte verwenden stets 4 WORDs.

Länge

  • Die Gesamtlänge ist die Summe aus TAG (1 WORD) und Payload (4 WORDs), also genau 5 WORDs, mit direkter Länge LLLL=0100. Length-Erweiterungs-TAG, descriptor und padding gibt es nicht.
  • Ist die Payload nicht genau 4 WORDs, wird der Wert abgelehnt.

Beispiel

  • 0 ns ist die Payload 0000 0000 0000 0000, insgesamt 5 WORDs, LLLL=0100. Das Ganze ist 0814 0000 0000 0000 0000.
  • 1 ns ist die Payload 0000 0000 0000 0001.
  • -1 ns ist die Payload FFFF FFFF FFFF FFFF.

Normative Grundlage

  • Das Apache Arrow Columnar Format bestimmt Schema.fbs zur maßgeblichen Quelle der Standard-Datentypen von Arrow.
  • Im maßgeblichen Schema.fbs von Arrow ist Duration eine kalenderunabhängige absolute Zeitspanne, die die Einheit NANOSECOND unterstützt und stets als 8-Byte-Ganzzahl mit Vorzeichen dargestellt wird. GEUL fügt dem nur TAG und das Big-Endian-16-Bit-WORD-Framing hinzu.

Originaltext des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00000810/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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