DURATION-NANOSECONDS — прошедшее время в signed наносекундах без epoch. Это не instant и не календарный промежуток в месяцах или годах.

ПунктЗначение
ИмяDURATION-NANOSECONDS (BIND в документе спецификации DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
Документ спецификации0x00000000/codecs/0x00000810/ (цель DECLARE 0810)
Раздел4 0100 (Value), смещение C внутри раздела = 1
KindValue · семейство: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
Описание в индексеПрошедшее время в signed наносекундах без epoch
Сторона Hugovalue/time/duration-nanoseconds.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1nanoseconds#2простое значение, 4 WORD

Раскладка

  • Код: прямой код Value 0x081L. Семейство TIME.
  • Используется тот же физический тип фиксированной ширины signed int64, что и в Arrow Duration(NANOSECOND).
TAG WORD          0x0814 (0000 1000 0001 0100)  всего 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

Интерпретация и действительность

  • Все 4 WORD Payload читаются как 64-битный signed счётчик в дополнительном коде с порядком WORD big-endian.
  • Допустимый диапазон — от -2^63 до 2^63-1 нс. Знак показывает направление отсчёта и не указывает на instant какого-либо epoch.
  • Даже малые значения всегда занимают 4 WORD.

Длина

  • Всего — ровно 5 WORD: TAG 1 WORD и Payload 4 WORD; используется прямая длина LLLL=0100. Расширяющего Length TAG, descriptor и padding нет.
  • Если Payload не равен ровно 4 WORD, значение отвергается.

Примеры

  • 0 нс: Payload 0000 0000 0000 0000, всего 5 WORD, LLLL=0100. Целиком: 0814 0000 0000 0000 0000.
  • 1 нс: Payload 0000 0000 0000 0001.
  • -1 нс: Payload FFFF FFFF FFFF FFFF.

Основание в стандартах

  • Apache Arrow Columnar Format назначает Schema.fbs авторитетным источником стандартных типов данных Arrow.
  • В авторитетном Schema.fbs Arrow Duration — абсолютное прошедшее время, не зависящее от календаря; поддерживается единица NANOSECOND, и значение всегда представляется 8-byte signed целым. GEUL добавляет лишь TAG и обрамление big-endian 16-битными WORD.

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x00000810/latest.geul, прочитанный командой geul show (шестнадцатеричные цифры заглавные).

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