DURATION-NANOSECONDS é um tempo decorrido em nanossegundos com sinal (signed), sem epoch. Não é um instant nem um período de meses ou anos do calendário.

ItemValor
NomeDURATION-NANOSECONDS (BIND do documento de especificação DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
Documento de especificação0x00000000/codecs/0x00000810/ (alvo de DECLARE 0810)
Seção4 0100 (Value), deslocamento C dentro da seção = 1
KindValue · família: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
Descrição do índiceTempo decorrido em nanossegundos com sinal, sem epoch
Lado Hugovalue/time/duration-nanoseconds.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (Documento de especificação de Codec).

OrdemCampo (BIND)FIELDLarguraFormato recebido (CODEC)ENUM
1nanoseconds#2valor bruto de 4 WORDs

Layout

  • Código: código direto de Value 0x081L. Família TIME.
  • Usa o mesmo tipo físico de largura fixa, int64 com sinal, que o Duration(NANOSECOND) do Arrow.
TAG WORD          0x0814 (0000 1000 0001 0100)  5 WORDs no total
Payload WORD 1st (bits 63..48)     Signed Nanoseconds 16 bits altos
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 baixos

Interpretação e validade

  • Os 4 WORDs do Payload são lidos, no seu conjunto, como uma contagem signed de 64 bits em complemento de dois, na ordem de WORDs big-endian.
  • O intervalo válido é -2^63~2^63-1 ns. O sinal é o sentido do tempo decorrido e não aponta para um instant de nenhum epoch específico.
  • Mesmo valores pequenos usam sempre 4 WORDs.

Comprimento

  • O total é exatamente 5 WORDs, 1 WORD de TAG mais 4 WORDs de Payload, e usa o comprimento direto LLLL=0100. Não há TAG de extensão de Length, descriptor nem padding.
  • Se o Payload não for exatamente 4 WORDs, rejeita-se.

Exemplo

  • 0 ns tem Payload 0000 0000 0000 0000, 5 WORDs no total, LLLL=0100. O total é 0814 0000 0000 0000 0000.
  • 1 ns tem Payload 0000 0000 0000 0001.
  • -1 ns tem Payload FFFF FFFF FFFF FFFF.

Base normativa

  • O Apache Arrow Columnar Format designa Schema.fbs como a authoritative source dos tipos de dados padrão do Arrow.
  • No Schema.fbs authoritative do Arrow, Duration é um tempo decorrido absoluto, independente do calendário, que suporta a unidade NANOSECOND e é sempre representado como inteiro com sinal de 8 bytes. GEUL acrescenta a isso apenas o TAG e o framing em WORDs big-endian de 16 bits.

Texto original do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00000810/latest.geul lido com geul show (hexadecimal em maiúsculas).

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