DURATION-NANOSECONDS adalah waktu berlalu signed dalam nanodetik tanpa epoch. Bukan instant dan bukan periode bulan·tahun kalender.

ButirNilai
NamaDURATION-NANOSECONDS (dokumen spesifikasi BIND DURATION-NANOSECONDS)
TAG ID0x081L
Codec ID0x00000810
Dokumen spesifikasi0x00000000/codecs/0x00000810/ (sasaran DECLARE 0810)
Bagian4 0100 (Value), offset dalam bagian C = 1
KindValue · keluarga: TIME
TAG WORD0000 1000 0001 LLLL (000K KKKC CCCC LLLL)
Deskripsi indeksWaktu berlalu signed dalam nanodetik tanpa epoch
Sisi Hugovalue/time/duration-nanoseconds.md

Field (dokumen spesifikasi)

Urutan FIELD dalam dokumen adalah urutan field Payload (dokumen spesifikasi Codec).

UrutanField (BIND)FIELDLebarFormat penerima (CODEC)ENUM
1nanoseconds#2nilai mentah 4 WORD

Layout

  • Kode: kode langsung Value 0x081L. Keluarga TIME.
  • Memakai tipe fisik signed int64 berlebar tetap yang sama dengan Duration(NANOSECOND) Arrow.
TAG WORD          0x0814 (0000 1000 0001 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

Interpretasi dan validitas

  • Seluruh 4 Payload WORD dibaca sebagai count signed komplemen dua 64 bit dengan urutan WORD big-endian.
  • Rentang valid adalah -2^63~2^63-1 ns. Tanda menyatakan arah waktu berlalu dan tidak menunjuk instant pada epoch tertentu.
  • Nilai kecil pun selalu memakai 4 WORD.

Panjang

  • Total adalah tepat 5 WORD, yaitu TAG 1 WORD ditambah Payload 4 WORD, dan memakai panjang langsung LLLL=0100. Tidak ada Length extension TAG, descriptor, maupun padding.
  • Jika Payload bukan tepat 4 WORD, ditolak.

Contoh

  • 0 ns: Payload 0000 0000 0000 0000, total 5 WORD, LLLL=0100. Totalnya 0814 0000 0000 0000 0000.
  • 1 ns: Payload 0000 0000 0000 0001.
  • -1 ns: Payload FFFF FFFF FFFF FFFF.

Dasar standar

  • Apache Arrow Columnar Format menetapkan Schema.fbs sebagai sumber otoritatif tipe data standar Arrow.
  • Pada Schema.fbs otoritatif Arrow, Duration adalah waktu berlalu absolut yang tidak terkait kalender, mendukung satuan NANOSECOND, dan selalu direpresentasikan sebagai bilangan bulat signed 8 byte. GEUL hanya menambahkan TAG dan framing WORD 16 bit big-endian.

Teks asli dokumen spesifikasi

Tampilan dokumen spesifikasi 0x00000000/codecs/0x00000810/latest.geul yang dibaca dengan geul show (heksadesimal huruf besar).

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