| Élément | Valeur |
|---|---|
| Nom | POSIX-TIMESTAMP-SECONDS (document de spécification BIND POSIX-TIMESTAMP-SECONDS) |
| TAG ID | 0x06CL |
| Codec ID | 0x000006C0 |
| Document de spécification | 0x00000000/codecs/0x000006C0/ (cible DECLARE 06C0) |
| Section | 3 0011 (Value), offset C dans la section = 12 |
| Kind | Value · famille : TIME |
| TAG WORD | 0000 0110 1100 LLLL (000K KKKC CCCC LLLL) |
| Description d’index | compte signed de secondes depuis l’epoch Unix/POSIX |
| Côté Hugo | value/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).
| Ordre | Champ (BIND) | FIELD | Largeur | Format reçu (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | seconds | #2 | valeur 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-1secondes. 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
timespecne fait que définir les membrestime_t tv_secetlong 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 detime_tdé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"