ButirNilai
NamaDURATION-SECONDS (dokumen spesifikasi BIND DURATION-SECONDS)
TAG ID0x06DL
Codec ID0x000006D0
Dokumen spesifikasi0x00000000/codecs/0x000006D0/ (sasaran DECLARE 06D0)
Bagian3 0011 (Value), offset dalam bagian C = 13
KindValue · keluarga: TIME
TAG WORD0000 0110 1101 LLLL (000K KKKC CCCC LLLL)
Deskripsi indekswaktu yang berlalu dalam SI-second bertanda tanpa epoch
Sisi Hugovalue/time/duration-seconds.md

Field (dokumen spesifikasi)

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

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

DURATION-SECONDS adalah waktu yang berlalu dalam satuan detik bertanda tanpa epoch. Ini bukan instant maupun rentang bulan dan tahun menurut kalender.

Layout

  • Kode: kode langsung Value 0x06DL. Keluarga TIME.
  • Memakai tipe fisik int64 bertanda berlebar tetap yang sama dengan Arrow Duration(SECOND).
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

Interpretasi dan validitas

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

Panjang

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

Contoh

  • 0 detik adalah Payload 0000 0000 0000 0000, total 5 WORD, LLLL=0100.
  • 1 detik adalah Payload 0000 0000 0000 0001.
  • -1 detik adalah Payload FFFF FFFF FFFF FFFF.

Dasar standar

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

Teks asli dokumen spesifikasi

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006D000000000
BODY
#1 DECLARE 0x06D0
#2 FIELD #1 0x0004
#3 BIND #1 "DURATION-SECONDS"
#4 BIND #2 "seconds"