EDTF adalah Value yang memuat tanggal dengan presisi tahun atau bulan, SM, ketidakpastian, dan interval melalui string tanggal diperluas ISO 8601-2 (Codec 0x06EL/0x06FL).

ButirNilai
NamaEDTF (kelompok genap-ganjil. Nama per kode ada pada tabel anggota di bawah)
TAG ID0x06EL·0x06FL
Bagian3 0011 (Value), offset dalam bagian C = 14~15
KindValue · keluarga: TIME
Deskripsi indeksstring tanggal EDTF (ISO 8601-2). Jumlah byte genap·ganjil. Tanggal yang dapat ditulis dengan GREGORIAN-DATE tidak ditulis dengan format ini
Sisi Hugovalue/time/edtf.md

Anggota

Halaman ini membahas dua kode pasangan genap-ganjil sekaligus. Kode genap adalah nilai dengan jumlah byte genap, kode ganjil dengan jumlah byte ganjil (Record dan TAG WORD). Dokumen Codec ada satu per kode. Field pada kedua dokumen Codec sama, hanya sasaran DECLARE dan nama (BIND) yang berbeda.

TAG IDNamaJumlah byteCodec IDDokumen spesifikasiTAG WORD
0x06ELEDTF-EVENgenap0x000006E00x00000000/codecs/0x000006E0/0000 0110 1110 LLLL
0x06FLEDTF-ODDganjil0x000006F00x00000000/codecs/0x000006F0/0000 0110 1111 LLLL

Field (dokumen spesifikasi)

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

UrutanField (BIND)FIELDLebarFormat penerima (CODEC)ENUM
1bytes#2sisa nilai mentah (0xFFFF)

EDTF adalah Value yang memuat tanggal melalui string Extended Date/Time Format (Library of Congress AS, ISO 8601-2:2019). Format ini menyatakan presisi yang lebih kasar daripada hari, SM, ketidakpastian·perkiraan·sebagian tidak diketahui, dan interval.

Layout

  • Kode: kode langsung Value 0x06EL (jumlah byte genap)·0x06FL (jumlah byte ganjil). Keluarga TIME. Payload adalah string tetapi ditempatkan pada keluarga TIME.
  • Jumlah byte ditentukan oleh bit paling tidak signifikan Codec dan jumlah WORD Payload. Yaitu 2 × jumlah WORD Payload − bit paling tidak signifikan, dan Byte Count tidak disediakan (Value).
TAG WORD          0000 0110 111P LLLL      Codec 0x06EL/0x06FL (P = jumlah byte ganjil)
[Length extension TAG] jika total 15 WORD atau lebih
Payload WORD 1st ... Nth          byte ASCII string EDTF / jika ganjil, 0x00 di akhir

Interpretasi dan validitas

  • Deret byte adalah string ASCII yang mengikuti tata bahasa EDTF Level 0·1·2. String kosong adalah invalid.
  • Contoh: hari 1952-03-11, bulan 1952-03, tahun 1952, dekade 195X, 44 SM -0043, tidak pasti 1974?, perkiraan ~1974, interval 1952/2001, tahun besar Y-13799999999.
  • Tahun mengikuti gaya astronomis ISO 8601. 0000 adalah 1 SM, -0043 adalah 44 SM. Saat memindahkan dari penulisan gaya historis, tahunnya digeser satu.
  • Kalender Gregorian. EDTF tidak menangani kalender lain. Penulisan asli kalender lain seperti kalender Julian disimpan dengan GEDCOM-DATE. Nilai yang memindahkan hari atau periode yang sama dengan tanggal itu ke kalender Gregorian dapat ditulis dengan EDTF atau GREGORIAN-DATE.
  • Bentuk kanonik: tanggal yang dapat ditulis secara tepat dengan GREGORIAN-DATE, yaitu [-]YYYY-MM-DD tanpa kualifikator (?, ~, %), digit tidak diketahui (X), interval, dan awalan Y, ditulis dengan GREGORIAN-DATE. Menulis tanggal seperti ini dengan EDTF adalah invalid. Hanya jika hari yang sama ditulis dalam satu format saja, tanggal dapat diindeks dan dibandingkan sebagai waktu.
  • Schema belum memeriksa tata bahasa EDTF. Produsen memeriksanya dengan parser EDTF. Contoh: parser.ParseString dari github.com/sfomuseum/go-edtf (BSD-3-Clause). parser.IsValid hanya melihat tata bahasa sehingga meloloskan 2023-02-29 dan 1974-13, jadi tidak dipakai. Parser ini belum mendukung tahun berawalan Y.

Panjang

  • Total adalah jumlah WORD dari TAG 1 WORD, Length extension TAG (jika ada), dan Payload (Length).

Contoh

TanggalByteWORD total
19744 (genap)06E2 3139 3734
197X4 (genap)06E2 3139 3758
1952-037 (ganjil)06F4 3139 3532 2D30 3300

Dasar standar

Masalah terbuka

  • Pemeriksaan tata bahasa EDTF oleh pemeriksa (apakah pemeriksa bergantung pada pustaka eksternal).
  • Aturan memindahkan presisi abad dan milenium Wikidata menjadi digit tidak diketahui EDTF.

Halaman terkait

Teks asli dokumen spesifikasi

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006E000000000
BODY
#1 DECLARE 0x06E0
#2 FIELD #1 rest
#3 BIND #1 "EDTF-EVEN"
#4 BIND #2 "bytes"

Di atas adalah dokumen Codec EDTF-EVEN (0x06EL). Dokumen Codec anggota lain (EDTF-ODD) hanya berbeda pada Codec ID di DOC-ID, sasaran DECLARE, dan nama yang diikat (BIND) pada #1.