DURATION-NANOSECONDS adalah waktu berlalu signed dalam nanodetik tanpa epoch. Bukan instant dan bukan periode bulan·tahun kalender.
| Butir | Nilai |
|---|---|
| Nama | DURATION-NANOSECONDS (dokumen spesifikasi BIND DURATION-NANOSECONDS) |
| TAG ID | 0x081L |
| Codec ID | 0x00000810 |
| Dokumen spesifikasi | 0x00000000/codecs/0x00000810/ (sasaran DECLARE 0810) |
| Bagian | 4 0100 (Value), offset dalam bagian C = 1 |
| Kind | Value · keluarga: TIME |
| TAG WORD | 0000 1000 0001 LLLL (000K KKKC CCCC LLLL) |
| Deskripsi indeks | Waktu berlalu signed dalam nanodetik tanpa epoch |
| Sisi Hugo | value/time/duration-nanoseconds.md |
Field (dokumen spesifikasi)
Urutan FIELD dalam dokumen adalah urutan field Payload (dokumen spesifikasi Codec).
| Urutan | Field (BIND) | FIELD | Lebar | Format penerima (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | nanoseconds | #2 | nilai 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-1ns. 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. Totalnya0814 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.fbssebagai sumber otoritatif tipe data standar Arrow. - Pada Schema.fbs otoritatif Arrow,
Durationadalah 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"