Tag opening_hours sering kali terlihat rumit karena menggunakan sintaks yang sangat presisi. Berikut adalah rangkuman aturan dan contoh sintaks dasar, variabel tambahan, hingga tingkat lanjut untuk membantu pemetaan di OSM.

---

1. Aturan Dasar & Hari Kerja

Format dasar menggunakan kode hari (2 digit, wajib kapital di awal) dan format jam 24 jam.

• Mo-Fr 10:00-20:00; PH off
  • Senin–Jumat buka jam 10:00–20:00. Tutup pada Hari Libur Nasional (PH off).
• 09:00+ / Mo-Su 09:00+
  • Buka mulai jam 09:00 sampai tutup (tanda + digunakan jika jam tutup tidak ditentukan secara pasti).
• Mo 10:00-12:00,12:30-15:00
  • Penggunaan tanda koma , digunakan untuk jeda jam istirahat.
• Fr-Sa 18:00-03:00
  • Jam buka yang melintasi tengah malam (Jumat & Sabtu buka jam 18:00 hingga jam 03:00 dini hari berikutnya).
• Tu off / Su closed
  • Penandaan hari libur rutin (misal: Tutup setiap hari Selasa / Minggu).
• 24/7
  • Buka 24 jam sehari, 7 hari seminggu.

---

2. Catatan Kustom & Persyaratan Spesifik

Teks di dalam tanda petik "" digunakan untuk memberikan catatan khusus bagi pengguna.

• "hanya setelah pendaftaran"; PH off
  • Hanya menerima kunjungan setelah pendaftaran/reservasi.
• Mo-Sa 10:00-20:00 "atau bisa dengan perjanjian"; PH off
  • Buka Senin–Sabtu, dengan catatan dapat dilayani di luar jam tersebut melalui perjanjian.
• Mo 12:00-14:00 open "khusus wanita", Mo 14:00-16:00 open "khusus pria"
  • Pembagian slot khusus pengunjung wanita dan pria.
• We-Fr 10:00-24:00 open "buka" || "silakan hubungi"; PH off
  • Opsi pesan kondisi buka atau arahan untuk menghubungi via telepon.
• Mo-Fr 08:00-11:00 || Tu-Th,PH open "Hanya darurat"
  • Layanan khusus untuk kondisi darurat pada hari/jam tertentu.
• Tu-Th,We 22:00-23:00 open "Makanan hangat"; PH off
  • Buka khusus menyediakan menu makanan hangat.

---

3. Musim, Batas Bulanan & Rentang Tanggal

Menentukan jam buka yang hanya berlaku pada musim, bulan, atau rentang tanggal tertentu.

Kode Singkatan Musim (Season):

• Su = Summer (Musim Panas)
• Wi = Winter (Musim Dingin)
• Sp = Spring (Musim Semi)
• Au = Autumn / Fall (Musim Gugur)

Catatan Musim vs Hari: Karena Su digunakan untuk Summer dan Sunday (Hari Minggu), parser OSM membedakannya berdasarkan posisi sintaks:

• Su 08:00-20:00 -> Selama Musim Panas, buka 08:00–20:00 setiap hari.

• Mo-Su 08:00-20:00 -> Senin sampai Hari Minggu, buka 08:00–20:00.

• Su Mo-Fr 08:00-20:00 -> Pada Musim Panas, khusus hari Senin–Jumat buka 08:00–20:00.

Contoh Sintaks:

• Su 08:00-20:00; Wi 09:00-17:00
  • Perbedaan jam buka berdasarkan musim (Summer & Winter).
• Apr: 22:00-23:00; PH off
  • Hanya berlaku di bulan April.
• Jul 23-Jan 3: 08:00-11:00 "Harap buat reservasi melalui telepon."; PH off
  • Berlakunya spesifik dari tanggal 23 Juli hingga 3 Januari tahun berikutnya dengan instruksi reservasi.
• 2026 Dec 20-31: off
  • Berlaku khusus pada rentang tanggal di tahun tertentu.

---

4. Jadwal Relatif (Pekan Ke-N & Fenomena Alam)

Sintaks OSM mendukung penentuan hari berdasarkan urutan pekan dalam sebulan atau waktu terbit/terbenam matahari.

• Sa[1] / Sa[-1]
  • Sa[1] = Sabtu pertama dalam bulan. Sa[-1] = Sabtu terakhir dalam bulan. (Wajib diawali huruf kapital).
• Sa[1],Sa[1] +1 day 10:00-12:00 open "akhir pekan pertama dalam bulan"
  • Sabtu pertama dan Minggu pertama (Sabtu + 1 hari) dalam sebulan.
• sunrise-sunset open "Hati-hati terik matahari!" / sunset-sunrise open "Waspada nyamuk!"
  • Jam operasional mengikuti waktu matahari terbit hingga terbenam (atau sebaliknya).
• (sunset+01:00)-24:00 || closed "Dilarang masuk sebelum matahari terbenam!"
  • Jam buka relatif setelah matahari terbenam dengan catatan khusus.

---

5. Minggu Ke-N (Week Number) & Hari Libur Spesifik

Digunakan untuk tempat yang memiliki aturan ganjil-genap atau tergantung tanggal merah.

• week 2-52/2 We 00:00-24:00
  • Buka hari Rabu pada minggu-minggu genap (/2).
• 2012 easter -2 days-2012 easter +2 days: open "Sekitar hari Paskah"
  • Jadwal khusus menyesuaikan hari raya keagamaan.
• 24/7 closed "selalu tutup"
  • Penandaan lokasi yang ditutup total secara permanen/sementara.
• PH Mo-Fr
  • Libur Nasional yang hanya berlaku jika jatuh pada hari kerja (Senin–Jumat).
• PH -1 day
  • Berlakunya pada H-1 sebelum Hari Libur Nasional.
• SH
  • Berlaku khusus pada masa Libur Sekolah (School Holiday).

---

6. Sub-Tag Layanan Khusus (Key Sub-tags)

Gunakan nama kunci (key) terpisah jika lokasi memiliki jam operasional berbeda untuk fasilitas spesifiknya.

• opening_hours:kitchen=11:00-21:00
  • Jam operasional khusus dapur/pemesanan makanan.
• opening_hours:drive_through=24/7
  • Jam operasional layanan lantatur (drive-thru).

---

7. Contoh Kesalahan Sintaks & Cara Memperbaikinya

Sering kali parser mengalami kegagalan (error) karena masalah kapitalisasi huruf, urutan, atau penulisan kata kunci yang salah.

• Salah: monday, Tu, wE, TH 12:00 - 20:00 ; 14:00-16:00 Off (Huruf kecil & format hari salah)
  • Benar: Mo,Tu,We,Th 12:00-14:00,16:00-20:00
• Salah: sa[1] 10:00-18:00 (Menggunakan sa kecil)
  • Benar: Sa[1] 10:00-18:00
• Salah: 00:00-24:00 week 6 Mo-Su Feb (Urutan sintaks terbalik)
  • Benar: Feb week 6 Mo-Su 00:00-24:00

---

Gunakan alat evaluasi seperti OpeningHoursEvaluator sebelum melakukan upload jika ragu dengan sintaks yang digunakan.