Sejak versi 11, PHPMaker memperkenalkan sebuah extension baru lagi yang bernama TimePicker (hanya untuk Pengguna yang membeli PHPMaker secara resmi dan mendapatkan kode lisensinya). Sekilas dari namanya kita dapat menyimpulkan bahwa extension ini berfungsi untuk memudahkan Pengguna dalam memilih data bertipe waktu dari beberapa pilihan yang dapat didefinisikan sebelumnya. Daripada mengetik data yang dapat menimbulkan kesalahan, maka akan lebih baik memilihnya dari beberapa pilihan yang tersedia.
Extension TimePicker sangat berguna jika di Aplikasi Web yang kita bangun membutuhkan pilihan waktu yang sudah ditentukan format data maupun interval pilihan waktu yang boleh dipilih. Contoh, kita hanya mengijinkan Pengguna untuk memilih data waktu dengan format hh:mm atau hh:mm:ss. Demikian juga dengan interval waktu menit di antara pilihan yang satu dengan berikutnya sebesar 10 menit, maka data pilihan yang tersedia adalah mulai dari 00:00, 00:10, 00:20, 00:30, …, 23:30, 23:40, 23:50, sampai yang terakhir 24:00.
Secara standar, extension TimePicker sangat cocok digunakan untuk Field yang bertipe Time pada database MySQL (saya belum sempat bereksperimen menggunakan database lain). Enaknya, extension ini akan secara otomatis mendeteksi Field yang bertipe Time pada semua object Table di project PHPMaker kita.
Dengan menggunakan extension ini, maka kita dapat mendisiplinkan Pengguna untuk memilih data waktu sesuai kriteria yang kita tetapkan seperti contoh di atas. Untuk itu, ada beberapa item pengaturan yang perlu kita perhatikan sebelum menggunakan extension ini di Aplikasi Web yang kita bangun dengan PHPMaker.
Untuk melihat pengaturan extension TimePicker, maka seperti biasa kita terlebih dulu harus mengklik menu Tools, lalu pilih Extensions. Selanjutnya scroll ke bagian paling bawah pada jendela Extensions, lalu aktifkan dengan memberi tanda centang pada item TimePicker yang terdapat di bawah Type: Time Picker.
Setelah itu Anda akan melihat sebuah tab Advanced muncul. Klik tab tersebut, Anda akan melihat list yang berisi tabel yang memiliki Field bertipe Time. Ada 3 item pengaturan untuk setiap Field yang masing-masing adalah sebagai berikut:
- TimeFormat, merupakan format waktu dalam notasi standar PHP. Secara standar bernilai kosong, dan jika item ini dikosongkan, maka extension TimePicker akan menggunakan format waktu lengkap, seperti misalnya: 10:30:00. Jika ingin menggunakan format tadi, maka Anda harus mengisi: G:i:s. Jika ingin menggunakan format jam dan menit saja seperti 10:30, maka Anda harus mengisi: G:i.
- Step, merupakan interval waktu dalam satuan menit antara pilihan satu dengan berikutnya. Secara standar bernilai kosong, dan jika dikosongkan akan menggunakan nilai 30, yang artinya akan menghasilkan interval 30 menit antara satu pilihan dengan pilihan berikutnya. Contoh: 10:30:00, 11:00:00, 11:30:00, dan seterusnya.
- Options, merupakan notasi JSON yang mewakili pilihan-pilihan tambahan lainnya yang digunakan oleh library jquery.timepicker. Secara standar bernilai kosong, dan menggunakan pilihan yang sudah terdefinisi di dalam library jquery.timepicker.
Untuk mempelajari lebih detail mengenai extension ini, khususnya untuk mengoptimalkan beberapa pilihan lainnya, Anda dapat melihat kode yang terdapat di dalam file jquery.timepicker.js.
Memang canggih kali PHPMaker ini, bah! 😀
Cak Sobri mengatakan
Gimana om caranya agar ew_CurrentDateTime agar sesuai jam di server ?
Masino Sinaga mengatakan
Mainkan pengaturan time_zone dari file .xml language.
Cak Sobri mengatakan
Saya rubah GMT ke Asia/Jakarta melalui [Tools][Advanced Settings][Default Time Zone] 🙂
aries mengatakan
Pengaturan time zone dari file .xml language. itu didirektori mana ya
Masino Sinaga mengatakan
Di direktori phplang.
ameisfine mengatakan
DI phpmaker2018 kok tidak muncul ya pak?
extensiona Date TIme picker > sudah enable
Format udah Date/Time
Masino Sinaga mengatakan
Pastikan tipe field yang Anda gunakan adalah Time, dan bukan DateTime.
Baca ulang lagi artikelnya dengan teliti ya.
Rudy B mengatakan
pak masino untuk setup min dan max time itu dimana ya ?
soalnya saya coba masukin json {‘minTime’: ‘8:00′,’maxTime’: ’19:00′} di Option nya tetep gk bisa ?
terimakasih
Masino Sinaga mengatakan
Ini Extension PHPMaker versi yang sudah sangat lama alias jadul, jadi tidak bisa digunakan di PHPMaker 2021 (versi terakhir saat komentar ini ditulis).