Date Range

Date Range digunakan untuk memilih tanggal mulai dan tanggal selesai dalam satu field, misalnya periode cuti atau masa tugas. Durasinya dihitung otomatis dalam hari kerja atau hari kalender.

Mapping ke Engine

Bila field kosong, nilai yang dikirim adalah null.

Properties

• Name: Label komponen yang ditampilkan ke pengguna. Mendukung dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Digenerate otomatis dan dapat disesuaikan.
• Placeholder: Teks petunjuk yang tampil selama rentang belum dipilih. Bila kosong, tampil "Select a date range".
• Format: Format tampilan tanggal di field: DD/MM/YYYY (default), MM/DD/YYYY, atau YYYY-MM-DD. Format ini hanya untuk tampilan; nilai tersimpan tetap yyyy-MM-dd.
• Count as: Cara menghitung durasi.
  • Working days (default): hanya Senin sampai Jumat yang dihitung. Hari libur nasional tidak dikurangi.
  • Calendar days: semua hari dihitung.
• Include end date: Bila aktif (default), tanggal selesai ikut dihitung. Contoh: 10-18 Okt 2026 dengan Calendar days bernilai 9 hari; tanpa Include end date bernilai 8 hari.
• Earliest date: Batas tanggal paling awal yang boleh dipilih. Pilihannya:
  • Today: tanggal hari ini.
  • From Other Field: tanggal diambil dari field lain, ditulis ${key_field}. Wajib diisi; bila kosong muncul "Please provide a field" dan Save Changes nonaktif.
  • Fixed date: tanggal tetap.
• Latest date: Batas tanggal paling akhir yang boleh dipilih, dengan pilihan yang sama seperti Earliest date. Bila Earliest date dan Latest date sama-sama Fixed date dan urutannya terbalik, muncul "Earliest date cannot be after latest date" dan Save Changes nonaktif.
• Tooltip: Teks bantuan singkat (maks. 255 karakter) yang muncul saat kursor diarahkan ke ikon informasi; diaktifkan lewat toggle.
• Disabled: Menonaktifkan komponen sehingga nilainya hanya bisa dibaca dan tidak dapat diisi.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation:
  • Required: Komponen wajib diisi sebelum form disubmit. Komponen ini tidak memiliki Required If.

Perilaku saat diisi

• Pemilih menampilkan dua bulan berdampingan, plus isian Start date dan End date yang bisa diketik.
• Klik pertama menentukan tanggal mulai, klik kedua menentukan tanggal selesai. Tanggal di luar Earliest date dan Latest date tidak bisa diklik.
• Tombol Done aktif setelah kedua tanggal terisi. Field lalu menampilkan rentang dan chip durasi, misalnya "5 working days".
• Bila batas memakai From Other Field, batasnya ikut berubah saat nilai field acuan berubah.
• Pesan validasi:
  • "<Name> is required": Required aktif dan field kosong, misalnya "Leave period is required".
  • "Pick an end date": baru tanggal mulai yang dipilih.
  • "End date must be on or after the start date": tanggal selesai lebih awal dari tanggal mulai.
  • "Start date can't be before <tanggal>" dan "End date can't be after <tanggal>": tanggal di luar batas.
  • "This range has no working days": Count as Working days dan rentang hanya berisi Sabtu-Minggu.
• Field yang dibuka ulang dengan nilai tersimpan menampilkan lagi rentang dan durasinya.
• Bila Disabled aktif, field tampil pudar, tidak bisa dibuka, dan nilainya tidak ikut dikirim saat form disubmit.