DURATION-NANOSECONDS es un tiempo transcurrido en nanosegundos con signo y sin epoch. No es un instant ni un período de meses o años del calendario.

ElementoValor
NombreDURATION-NANOSECONDS (BIND del documento de especificación DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
Documento de especificación0x00000000/codecs/0x00000810/ (destino de DECLARE 0810)
Sección4 0100 (Value), desplazamiento C dentro de la sección = 1
KindValue · familia: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
Descripción del índiceTiempo transcurrido en nanosegundos con signo y sin epoch
Lado Hugovalue/time/duration-nanoseconds.md

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato que recibe (CODEC)ENUM
1nanoseconds#2valor en bruto de 4 WORD

Layout

  • Código: código directo de Value 0x081L. Familia TIME.
  • Usa el mismo tipo físico signed int64 de ancho fijo que Duration(NANOSECOND) de Arrow.
TAG WORD          0x0814 (0000 1000 0001 0100)  5 WORD en total
Payload WORD 1st (bits 63..48)     Signed Nanoseconds 16 bits superiores
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 inferiores

Interpretación y validez

  • Los 4 WORD de Payload completos se leen como un count con signo en complemento a dos de 64 bits, en orden de WORD big-endian.
  • El rango válido es de -2^63 a 2^63-1 ns. El signo es la dirección del transcurso y no apunta al instant de ningún epoch concreto.
  • Incluso los valores pequeños usan siempre 4 WORD.

Longitud

  • El total son exactamente 5 WORD, la suma de 1 WORD de TAG y 4 WORD de Payload, y usa la longitud directa LLLL=0100. No hay TAG de extensión de Length, descriptor ni padding.
  • Si el Payload no es exactamente 4 WORD, se rechaza.

Ejemplo

  • 0 ns tiene Payload 0000 0000 0000 0000, 5 WORD en total y LLLL=0100. El total es 0814 0000 0000 0000 0000.
  • 1 ns tiene Payload 0000 0000 0000 0001.
  • -1 ns tiene Payload FFFF FFFF FFFF FFFF.

Fundamento normativo

  • Apache Arrow Columnar Format designa Schema.fbs como fuente autorizada de los tipos de datos estándar de Arrow.
  • En el Schema.fbs autorizado de Arrow, Duration es un tiempo transcurrido absoluto independiente del calendario, admite la unidad NANOSECOND y se representa siempre como un entero con signo de 8 bytes. GEUL solo añade a esto el TAG y el framing de WORD de 16 bits big-endian.

Texto original del documento de especificación

Es el aspecto del documento de especificación 0x00000000/codecs/0x00000810/latest.geul leído con geul show (hexadecimal en mayúsculas).

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