EintragWert
NamePOSIX-TIMESTAMP-SECONDS (Spezifikationsdokument BIND POSIX-TIMESTAMP-SECONDS)
TAG ID0x06CL
Codec ID0x000006C0
Spezifikationsdokument0x00000000/codecs/0x000006C0/ (DECLARE-Ziel 06C0)
Abschnitt3 0011 (Value), Offset C im Abschnitt = 12
KindValue · Familie: TIME
TAG WORD0000 0110 1100 LLLL (000K KKKC CCCC LLLL)
Index-Beschreibungvorzeichenbehaftete Sekundenzählung seit der Unix/POSIX-Epoche
Hugo-Seitevalue/time/posix-timestamp-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

POSIX-TIMESTAMP-SECONDS ist die vorzeichenbehaftete Sekundenzahl seit der Unix-Epoche 1970-01-01T00:00:00Z. Wie bei den Seconds Since the Epoch von POSIX hat jeder Tag genau 86.400 Sekunden, und Schaltsekunden werden nicht gezählt.

Layout

  • Code: direkter Value-Code 0x06CL. Familie TIME.
  • Für den Austausch industrieller Daten wird derselbe physische Typ fester Breite wie bei Arrow timestamp[s] verwendet, ein vorzeichenbehafteter int64.
TAG WORD          0x06C4 (0000 0110 1100 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. Negative Werte sind Instants vor der Epoche.
  • Auch kleine Werte verwenden immer 4 WORD. Sie dürfen nicht auf die Ganzzahldarstellung mit minimaler WORD-Anzahl verkürzt werden.
  • Zeitzone, ursprünglicher UTC-Offset, Schaltsekunden-Label und Schaltsekundentabelle werden nicht aufgenommen.

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

  • Die Epoche ist der Payload 0000 0000 0000 0000, insgesamt 5 WORD, LLLL=0100.
  • 1 Sekunde nach der Epoche ist der Payload 0000 0000 0000 0001.
  • 1 Sekunde vor der Epoche ist der Payload FFFF FFFF FFFF FFFF.

Normative Grundlage

  • POSIX.1-2024 timespec definiert nur die Member time_t tv_sec und long tv_nsec, nicht aber ein Wire-Format, das die kumulierten Sekunden als vorzeichenbehafteten int64 serialisiert. Breite und Darstellung von time_t hängen von der Implementierungsumgebung ab und sind nicht mit der GEUL-Payload-Darstellung identisch.
  • POSIX.1-2024 Seconds Since the Epoch definiert die Kalenderentsprechung der Sekunden seit der Epoche und die Regel von 86.400 Sekunden pro Tag.
  • Das Apache Arrow Columnar Format und die maßgebliche Schema.fbs definieren timestamp als 64-Bit-Ganzzahl mit Vorzeichen ab einer festen Epoche und unterstützen die Einheit SECOND sowie die Nichtzählung von Schaltsekunden. GEUL fügt diesem physischen Typ nur den TAG und das big-endian-16-Bit-WORD-Framing hinzu.

Originaltext des Spezifikationsdokuments

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006C000000000
BODY
#1 DECLARE 0x06C0
#2 FIELD #1 0x0004
#3 BIND #1 "POSIX-TIMESTAMP-SECONDS"
#4 BIND #2 "seconds"