ButirNilai
NamaPOSIX-TIMESTAMP-SECONDS (dokumen spesifikasi BIND POSIX-TIMESTAMP-SECONDS)
TAG ID0x06CL
Codec ID0x000006C0
Dokumen spesifikasi0x00000000/codecs/0x000006C0/ (sasaran DECLARE 06C0)
Bagian3 0011 (Value), offset dalam bagian C = 12
KindValue · keluarga: TIME
TAG WORD0000 0110 1100 LLLL (000K KKKC CCCC LLLL)
Deskripsi indekshitungan detik bertanda sejak epoch Unix/POSIX
Sisi Hugovalue/time/posix-timestamp-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

POSIX-TIMESTAMP-SECONDS adalah jumlah detik bertanda sejak epoch Unix 1970-01-01T00:00:00Z. Seperti seconds-since-the-Epoch pada POSIX, setiap hari dianggap tepat 86.400 detik dan detik kabisat tidak dihitung.

Layout

  • Kode: kode langsung Value 0x06CL. Keluarga TIME.
  • Untuk pertukaran data industri, dipakai tipe fisik int64 bertanda berlebar tetap yang sama dengan Arrow timestamp[s].
TAG WORD          0x06C4 (0000 0110 1100 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. Nilai negatif adalah instant sebelum epoch.
  • Nilai kecil pun selalu memakai 4 WORD. Tidak boleh dipersingkat menjadi representasi bilangan bulat dengan WORD minimum.
  • Zona waktu, offset UTC asli, label detik kabisat, dan tabel detik kabisat tidak dimuat.

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

  • Epoch adalah Payload 0000 0000 0000 0000, total 5 WORD, LLLL=0100.
  • 1 detik setelah epoch adalah Payload 0000 0000 0000 0001.
  • 1 detik sebelum epoch adalah Payload FFFF FFFF FFFF FFFF.

Dasar standar

  • POSIX.1-2024 timespec hanya mendefinisikan anggota time_t tv_sec dan long tv_nsec, dan tidak mendefinisikan wire format yang menyerialisasi detik kumulatif sebagai int64 bertanda. Lebar dan representasi konkret time_t bergantung pada lingkungan implementasi dan tidak sama dengan representasi Payload GEUL.
  • POSIX.1-2024 Seconds Since the Epoch mendefinisikan padanan kalender untuk detik setelah epoch dan aturan 86.400 detik per hari.
  • Apache Arrow Columnar Format dan Schema.fbs yang otoritatif mendefinisikan timestamp sebagai bilangan bulat bertanda 64 bit sejak epoch tetap, mendukung satuan SECOND, dan tidak menghitung detik kabisat. GEUL hanya menambahkan TAG dan framing WORD 16 bit big-endian pada tipe fisik ini.

Teks asli dokumen spesifikasi

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006C000000000
BODY
#1 DECLARE 0x06C0
#2 FIELD #1 0x0004
#3 BIND #1 "POSIX-TIMESTAMP-SECONDS"
#4 BIND #2 "seconds"