ÉlémentValeur
NomPOSIX-TIMESTAMP-SECONDS (document de spécification BIND POSIX-TIMESTAMP-SECONDS)
TAG ID0x06CL
Codec ID0x000006C0
Document de spécification0x00000000/codecs/0x000006C0/ (cible DECLARE 06C0)
Section3 0011 (Value), offset C dans la section = 12
KindValue · famille : TIME
TAG WORD0000 0110 1100 LLLL (000K KKKC CCCC LLLL)
Description d’indexcompte signed de secondes depuis l’epoch Unix/POSIX
Côté Hugovalue/time/posix-timestamp-seconds.md

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1seconds#2valeur brute 4 WORD

POSIX-TIMESTAMP-SECONDS est un nombre de secondes signed depuis l’epoch Unix 1970-01-01T00:00:00Z. Comme les seconds-since-the-Epoch de POSIX, il compte chaque jour pour exactement 86 400 secondes et ne compte pas les secondes intercalaires.

Disposition

  • Code : code direct Value 0x06CL. Famille TIME.
  • Pour l’échange de données industrielles, on utilise le même type physique int64 signed de largeur fixe que timestamp[s] d’Arrow.
TAG WORD          0x06C4 (0000 0110 1100 0100)  total 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

Interprétation et validité

  • Les 4 WORD du Payload sont lus comme un compte signed en complément à deux sur 64 bits, dans l’ordre des WORD big-endian.
  • L’intervalle valide va de -2^63 à 2^63-1 secondes. Une valeur négative est un instant antérieur à l’epoch.
  • Même une petite valeur occupe toujours 4 WORD. On ne doit pas la réduire à une représentation entière à nombre minimal de WORD.
  • Ni fuseau horaire, ni décalage UTC d’origine, ni label de seconde intercalaire, ni table de secondes intercalaires ne sont portés.

Longueur

  • Le total est exactement de 5 WORD, soit 1 WORD de TAG plus 4 WORD de Payload, avec la longueur directe LLLL=0100. Il n’y a ni TAG d’extension de Length, ni descriptor, ni padding.
  • Si le Payload n’est pas exactement de 4 WORD, il est rejeté.

Exemple

  • L’epoch est le Payload 0000 0000 0000 0000, 5 WORD au total, LLLL=0100.
  • 1 seconde après l’epoch est le Payload 0000 0000 0000 0001.
  • 1 seconde avant l’epoch est le Payload FFFF FFFF FFFF FFFF.

Fondement normatif

  • POSIX.1-2024 timespec ne fait que définir les membres time_t tv_sec et long tv_nsec ; il ne définit pas de wire format qui sérialise les secondes cumulées en int64 signed. La largeur et la représentation concrètes de time_t dépendent de l’environnement d’implémentation et ne sont pas identiques à la représentation du Payload GEUL.
  • POSIX.1-2024 Seconds Since the Epoch définit la correspondance calendaire des secondes depuis l’epoch et la règle des 86 400 secondes par jour.
  • Le Apache Arrow Columnar Format et son Schema.fbs faisant autorité définissent timestamp comme un entier signed de 64 bits depuis une epoch fixe, avec l’unité SECOND, et sans comptage des secondes intercalaires. GEUL n’ajoute à ce type physique que le TAG et le framing en WORD de 16 bits big-endian.

Texte source du document de spécification

Voici le document de spécification 0x00000000/codecs/0x000006C0/latest.geul tel que lu par geul show (hexadécimal en majuscules).

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