ItemValor
NomeCIVIL-TIME-NANOSECONDS (BIND CIVIL-TIME-NANOSECONDS do documento de especificação)
TAG ID0x06BL
Codec ID0x000006B0
Documento de especificação0x00000000/codecs/0x000006B0/ (alvo do DECLARE 06B0)
Seção3 0011 (Value), deslocamento C na seção = 11
KindValue · família: TIME
TAG WORD0000 0110 1011 LLLL (000K KKKC CCCC LLLL)
Descrição no índicecontagem unsigned de nanosecond após a meia-noite do dia civil
Lado Hugovalue/time/civil-time-nanoseconds.md

Campos (documento de especificação)

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

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

CIVIL-TIME-NANOSECONDS representa uma hora civil sem data como o número de nanosecond após a meia-noite.

Layout

  • Código: direct code de Value 0x06BL. Família TIME.
  • Usa o mesmo tipo físico de largura fixa int64 signed que o TIME(isAdjustedToUTC=false, unit=NANOS) do Parquet.
TAG WORD          0x06B4 (0000 0110 1011 0100)  total 5 WORD
Payload WORD 1st (bits 63..48)     Signed Nanoseconds high 16bit
Payload WORD 2nd (bits 47..32)     Signed Nanoseconds
Payload WORD 3rd (bits 31..16)     Signed Nanoseconds
Payload WORD 4th (bits 15..0)      Signed Nanoseconds low 16bit

Interpretação e validade

  • As 4 WORD do Payload são lidas inteiras como uma contagem signed de 64 bits em complemento de dois, em ordem de WORD big-endian.
  • O tipo físico é int64 signed, mas o intervalo válido é 0 <= value < 86,400×10^9 ns. Negativos e valores iguais ou superiores ao limite são rejeitados.
  • 24:00 e labels de segundo intercalar não são admitidos. Também não guarda data, fuso horário nem UTC offset.
  • Mesmo valores pequenos usam sempre 4 WORD.

Comprimento

  • O total é exatamente 5 WORD, somando 1 WORD de TAG e 4 WORD 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 tiver exatamente 4 WORD, é rejeitado.

Exemplo

  • A meia-noite é o Payload 0000 0000 0000 0000, total de 5 WORD, LLLL=0100.
  • 1 ns após a meia-noite é o Payload 0000 0000 0000 0001.
  • 86,400×10^9 ns é igual ao limite, portanto não é válido.
  • FFFF FFFF FFFF FFFF é -1 como int64 signed, portanto não é válido.

Base normativa

  • O TIME(isAdjustedToUTC=false, unit=NANOS) do Apache Parquet Logical Types guarda em um int64 os nanosecond após a meia-noite da hora local e usa a ordenação signed.
  • O Apache Arrow Columnar Format, em seu Schema.fbs de referência, define o Time NANOSECOND como inteiro signed de 64 bits, limita o intervalo válido a menos de 86.400 segundos a partir da meia-noite inclusive e não admite segundo intercalar. O GEUL acrescenta apenas o TAG e o enquadramento em WORD de 16 bits big-endian.

Texto original do documento de especificação

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006B000000000
BODY
#1 DECLARE 0x06B0
#2 FIELD #1 0x0004
#3 BIND #1 "CIVIL-TIME-NANOSECONDS"
#4 BIND #2 "nanoseconds"