TDatePicker

TDatePicker menampilkan kotak teks untuk keperluan input tanggal. Ketika kotak teks menerima fokus, kalender akan muncul dan pengguna dapat mengambil tanggal darinya yang akan secara otomatis dimasukan ke dalam kotak teks. Format tanggal string yang ditampilkan dalam kotak teks ditentukan oleh properti DateFormat. Format yang benar adalah kombinasi dari token berikut: Karakter Pola Format (en-US) --------------------------------------------------------------------- d digit hari dd digit hari diisi misalnya 01, 02 M digit bulan MM digit bulan diisi MMM singkatan nama bulan yang dilokalisasi, misalnya Mar, Apr MMMM nama bulan yang dilokalisasi, misalnya March, April yy 2 digit tahun yyyy 4 digit tahun ---------------------------------------------------------------------

Tanggal pada pengambil tanggal bisa disetel menggunakan properti Date atau Timestamp. Nilai properti Date harus dalam format yang sama seperti pola yang ditetapkan dalam properti DateFormat. Properti Timestamp hanya menerima integer seperti cap waktu Unix.

TDatePicker mempunyai tiga Mode untuk menampilkan tampilan pengambil tanggal.

• Basic - Hanya menampilkan input teks, memfokuskan pada input menampilkan pengambil tanggal.
• Button - Menampilkan tombol disebelah input teks, mengklik pada tombol tampilkan tanggal, teks tombol dapat diubah dengan properti ButtonText.
• ImageButton - Menampilkan gambar di sebelah input teks, mengklik pada gambar pengambil tanggal, sumber gambar bisa diubah melalui properti ImageUrl.

Properti CssClass dapat dipakai untuk mengganti nama kelas CSS untuk panel pengambil tanggal. Properti CalendarStyle mengubah gaya kalender secara keseluruhan. Nilai CalendarStyle berikut tersedia:

• default - gaya standar kalender.

Properti InputMode bisa disetel ke "TextBox" atau "DropDownList" dengan standar sebagai "TextBox". Dalam mode DropDownList, sebagai tambahan pada tampilan pengambil tanggal, tiga daftar drop down (hari, bulan dan tahun) disajikan untuk memilih tanggal. Ketika InputMode sama dengan "DropDownList", urutan dan penampilan tanggal, bulan, dan tahun akan bergantung pada pola yang ditetapkan dalam properti DateFormat.

Tampilan pengambil tanggal dapat disembunyikan dengan menetapkan ShowCalendar ke false. Banyak teks pada tampilan pengambil tanggal dapat diubah ke bahasa berbeda menggunakan properti Culture.

Batas tahun pengambil kalender dapat disetel menggunakan properti FromYear dan UpToYear di mana FromYear adalah tahun awal dan UpToYear adalah tahun terakhir yang dapat dipilih. Awal hari pada seminggu bisa diubah dengan properti FirstDayOfWeek, dengan 0 sebagai Minggu, 1 sebagai Senin, dst.

Catatan 1: Jika InputMode adalah "TextBox", DateFormat TIDAK boleh berisi pola MMM atau MMMM. Pengurai sisi-server tidak akan bisa menentukan tanggal yang benar jika MMM atau MMMM dipakai. Ketika InputMode sama dengan "DropDownList", seluruh pola dapat dipergunakan.

Catatan 2: Ketika TDatePicker dipakai bersama dengan validator, properti DateFormat pada validator harus sama dengan DateFormat pada TDatePicker DAN harus disetel DataType="Date" pada validator guna memastikan validasi yang benar. Lihat TCompareValidator, TDataTypeValidator dan TRangeValidator untuk lebih jelasnya.