ButirNilai
NamaGREGORIAN-DATE (dokumen spesifikasi BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec ID0x000006A0
Dokumen spesifikasi0x00000000/codecs/0x000006A0/ (sasaran DECLARE 06A0)
Bagian3 0011 (Value), offset dalam bagian C = 10
KindValue · keluarga: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
Deskripsi indeksjumlah hari bertanda berdasarkan proleptic Gregorian 1970-01-01
Sisi Hugovalue/time/gregorian-date.md

Field (dokumen spesifikasi)

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

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

GREGORIAN-DATE adalah jumlah hari bertanda dengan proleptic Gregorian 1970-01-01 sebagai day 0. Zona waktu dan waktu dalam hari tidak dimuat.

Layout

  • Kode: kode langsung Value 0x06AL. Keluarga TIME.
  • Memakai tipe fisik int32 bertanda berlebar tetap yang sama dengan Arrow Date32 dan Parquet DATE.
TAG WORD          0x06A2 (0000 0110 1010 0010)  total 3 WORD
Payload WORD 1st (bits 31..16)     Signed Day Count high 16bit
Payload WORD 2nd (bits 15..0)      Signed Day Count low 16bit

Interpretasi dan validitas

  • Seluruh Payload 2 WORD dibaca sebagai day count bertanda komplemen dua 32 bit dengan urutan WORD big-endian.
  • Rentang yang valid adalah -2^31 sampai 2^31-1 hari. Nilai negatif adalah tanggal sebelum epoch.
  • Saat menghitung balik day count menjadi tahun, bulan, dan tanggal, dipakai kalender proleptic Gregorian tanpa peralihan kalender historis.
  • Nilai kecil pun selalu memakai 2 WORD.

Panjang

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

Contoh

TanggalPayloadLength total
1970-01-010000 00003 WORD (LLLL=0010)
1970-01-020000 00013 WORD (LLLL=0010)
1969-12-31FFFF FFFF3 WORD (LLLL=0010)

Hubungan dengan EDTF

  • Presisi yang lebih kasar daripada hari, ketidakpastian atau perkiraan, dan interval ditulis dengan EDTF. Tanggal yang dapat ditulis secara tepat dengan GREGORIAN-DATE tidak ditulis dengan EDTF (bentuk kanonik EDTF).

Dasar standar

  • DATE pada Apache Parquet Logical Types adalah int32 yang menyimpan jumlah hari sejak 1970-01-01, epoch Unix, dan memakai urutan bertanda.
  • Date32 pada Apache Arrow Columnar Format dan Schema.fbs yang otoritatif menyimpan jumlah hari sejak epoch Unix sebagai bilangan bulat bertanda 32 bit.
  • Penghitungan balik proleptic Gregorian adalah profil kalender GEUL yang diadopsi format ini. Makna day count int32 Arrow/Parquet dibiarkan apa adanya, dan hanya ditambahkan TAG dan framing WORD 16 bit big-endian.

Teks asli dokumen spesifikasi

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006A000000000
BODY
#1 DECLARE 0x06A0
#2 FIELD #1 0x0002
#3 BIND #1 "GREGORIAN-DATE"
#4 BIND #2 "days"