DURATION-NANOSECONDS est un temps écoulé en nanosecondes signées, sans epoch. Ce n’est ni un instant ni une durée calendaire en mois ou en années.

ÉlémentValeur
NomDURATION-NANOSECONDS (BIND DURATION-NANOSECONDS du document de spécification)
TAG ID0x081L
Codec ID0x00000810
Document de spécification0x00000000/codecs/0x00000810/ (cible de DECLARE 0810)
Section4 0100 (Value), décalage dans la section C = 1
KindValue · famille : TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
Description de l’indexTemps écoulé en nanosecondes signées, sans epoch
Côté Hugovalue/time/duration-nanoseconds.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
1nanoseconds#2valeur brute de 4 WORD

Disposition

  • Code : code direct de Value 0x081L. Famille TIME.
  • Il utilise le même type physique à largeur fixe, int64 signé, que Duration(NANOSECOND) d’Arrow.
TAG WORD          0x0814 (0000 1000 0001 0100)  total 5 WORD
Payload WORD 1st (bits 63..48)     Signed Nanoseconds 16 bits de poids fort
Payload WORD 2nd (bits 47..32)     Signed Nanoseconds
Payload WORD 3rd (bits 31..16)     Signed Nanoseconds
Payload WORD 4th (bits 15..0)      Signed Nanoseconds 16 bits de poids faible

Interprétation et validité

  • On lit l’ensemble des 4 WORD du Payload comme un compte signé en complément à deux sur 64 bits, dans l’ordre des WORD big-endian.
  • La plage valide est -2^63~2^63-1 ns. Le signe est le sens du temps écoulé et ne désigne pas l’instant d’un epoch particulier.
  • Même une petite valeur utilise toujours 4 WORD.

Longueur

  • Le total est exactement 5 WORD, TAG 1 WORD plus Payload 4 WORD, avec la longueur directe LLLL=0100. Il n’y a ni TAG d’extension Length, ni descriptor, ni padding.
  • On rejette si le Payload n’est pas exactement 4 WORD.

Exemple

  • 0 ns a pour Payload 0000 0000 0000 0000, un total de 5 WORD et LLLL=0100. Le total est 0814 0000 0000 0000 0000.
  • 1 ns a pour Payload 0000 0000 0000 0001.
  • -1 ns a pour Payload FFFF FFFF FFFF FFFF.

Fondement normatif

  • Le Apache Arrow Columnar Format désigne Schema.fbs comme la source authoritative des types de données standard d’Arrow.
  • Dans le Schema.fbs authoritative d’Arrow, Duration est un temps écoulé absolu indépendant du calendrier ; il prend en charge l’unité NANOSECOND et se représente toujours par un entier signé de 8 octets. GEUL n’y ajoute que le TAG et le framing en WORD big-endian de 16 bits.

Texte original du document de spécification

Aspect du document de spécification 0x00000000/codecs/0x00000810/latest.geul lu avec geul show (hexadécimal en majuscules).

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