EintragWert
NameDURATION-SECONDS (Spezifikationsdokument BIND DURATION-SECONDS)
TAG ID0x06DL
Codec ID0x000006D0
Spezifikationsdokument0x00000000/codecs/0x000006D0/ (DECLARE-Ziel 06D0)
Abschnitt3 0011 (Value), Offset C im Abschnitt = 13
KindValue · Familie: TIME
TAG WORD0000 0110 1101 LLLL (000K KKKC CCCC LLLL)
Index-Beschreibungvorzeichenbehaftete verstrichene Zeit in SI-Sekunden ohne Epoche
Hugo-Seitevalue/time/duration-seconds.md

Felder (Spezifikationsdokument)

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

Nr.Feld (BIND)FIELDBreiteZielformat (CODEC)ENUM
1seconds#2Rohwert 4 WORD

DURATION-SECONDS ist eine vorzeichenbehaftete verstrichene Zeit in Sekunden ohne Epoche. Es ist weder ein Instant noch eine kalendarische Monats- oder Jahresspanne.

Layout

  • Code: direkter Value-Code 0x06DL. Familie TIME.
  • Es wird derselbe physische Typ fester Breite wie bei Arrow Duration(SECOND) verwendet, ein vorzeichenbehafteter int64.
TAG WORD          0x06D4 (0000 0110 1101 0100)  insgesamt 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

Interpretation und Gültigkeit

  • Der gesamte Payload mit 4 WORD wird als vorzeichenbehafteter 64-Bit-Zweierkomplement-Count in big-endian-WORD-Reihenfolge gelesen.
  • Der gültige Bereich ist -2^63 bis 2^63-1 Sekunden. Das Vorzeichen ist die Richtung des Verstreichens und zeigt nicht auf einen Instant einer bestimmten Epoche.
  • Auch kleine Werte verwenden immer 4 WORD.

Länge

  • Die Gesamtzahl ist genau 5 WORD aus 1 WORD TAG und 4 WORD Payload, mit der direkten Länge LLLL=0100. Es gibt keinen Length-Erweiterungs-TAG, Descriptor oder Padding.
  • Ist der Payload nicht genau 4 WORD, wird abgelehnt.

Beispiel

  • 0 Sekunden ist der Payload 0000 0000 0000 0000, insgesamt 5 WORD, LLLL=0100.
  • 1 Sekunde ist der Payload 0000 0000 0000 0001.
  • -1 Sekunde ist der Payload FFFF FFFF FFFF FFFF.

Normative Grundlage

  • Das Apache Arrow Columnar Format bestimmt Schema.fbs als maßgebliche Quelle der Arrow-Standarddatentypen.
  • In der maßgeblichen Schema.fbs von Arrow ist Duration eine kalenderunabhängige absolute verstrichene Zeit, unterstützt die Einheit SECOND und wird immer als 8-Byte-Ganzzahl mit Vorzeichen dargestellt. GEUL fügt dem nur den TAG und das big-endian-16-Bit-WORD-Framing hinzu.

Originaltext des Spezifikationsdokuments

Das Spezifikationsdokument 0x00000000/codecs/0x000006D0/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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