| Item | Valor |
|---|---|
| Nome | DURATION-SECONDS (BIND DURATION-SECONDS do documento de especificação) |
| TAG ID | 0x06DL |
| Codec ID | 0x000006D0 |
| Documento de especificação | 0x00000000/codecs/0x000006D0/ (alvo do DECLARE 06D0) |
| Seção | 3 0011 (Value), deslocamento C na seção = 13 |
| Kind | Value · família: TIME |
| TAG WORD | 0000 0110 1101 LLLL (000K KKKC CCCC LLLL) |
| Descrição no índice | tempo decorrido signed em SI-second, sem epoch |
| Lado Hugo | value/time/duration-seconds.md |
Campos (documento de especificação)
A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).
| Ordem | Campo (BIND) | FIELD | Largura | Formato recebido (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | seconds | #2 | valor bruto de 4 WORD |
DURATION-SECONDS é um tempo decorrido signed em segundos, sem epoch. Não é um instant nem uma duração de meses ou anos do calendário.
Layout
- Código: direct code de Value
0x06DL. Família TIME. - Usa o mesmo tipo físico de largura fixa int64 signed que o
Duration(SECOND)do Arrow.
TAG WORD 0x06D4 (0000 0110 1101 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
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 intervalo válido é de
-2^63a2^63-1segundos. O sinal indica o sentido do tempo decorrido e não aponta o instant de nenhum epoch específico. - 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
- 0 segundo é o Payload
0000 0000 0000 0000, total de 5 WORD,LLLL=0100. - 1 segundo é o Payload
0000 0000 0000 0001. - -1 segundo é o Payload
FFFF FFFF FFFF FFFF.
Base normativa
- O Apache Arrow Columnar Format designa o
Schema.fbscomo a fonte autoritativa dos tipos de dados padrão do Arrow. - No Schema.fbs de referência do Arrow,
Durationé um tempo decorrido absoluto independente do calendário, suporta a unidade SECOND e é sempre representado como inteiro signed de 8 bytes. O GEUL acrescenta a isso 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/0x000006D0/latest.geul lido com geul show (hexadecimal em maiúsculas).
SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006D000000000
BODY
#1 DECLARE 0x06D0
#2 FIELD #1 0x0004
#3 BIND #1 "DURATION-SECONDS"
#4 BIND #2 "seconds"