Joomla! Documentation™

Jenis kolom form kalender memberikan sebuah kotak teks untuk entri sebuah tanggal. Sebuah ikon disamping kotak teks memberikan sebuah tautan ke kalender pop-up, yang dapat dipakai juga untuk memasukkan nilai tanggal. Jika kolom tersebut memiliki sebuah nilai yang disimpan maka akan ditampilkan di dalam kotak teks. Jika tidak maka nilai standar, kalau ada, akan ditampilkan.

• type (wajib) haruslah calendar.
• name (wajib) adalah nama unik kolom.
• label (wajib) (dapat diterjemahkan) adalah judul kolom deskriptif.

• default (opsional) adalah tanggal standar. Ini harus diberikan di dalam format yang sama dengan yang ditentukan oleh argumen format. Anda dapat meletakkan "NOW" untuk mendapatkan tanggal saat ini atau informasi waktu di dalam format yang diberikan.

• description (opsional) (dapat diterjemahkan) adalah teks yang akan ditampilkan sebagai sebuah tooltip ketika seorang pengguna menggerakkan tetikusnya ke atas kotak teks tersebut.
• readonly (opsional) adalah apakah kotak teks itu hanya dapat dibaca (read-only) (nilainya true atau false). Apabila kotak teks itu read-only, maka tanggal tidak dapat diganti, tapi dapat dipilih dan disalin. Tidak ada ikon kalender yang akan ditampilkan.
• disabled (opsional) adalah apakah kotak teks itu dinonaktifkan (true atau false). Jika kotak teks itu dinonaktfikan, maka tanggal tidak dapat diganti, dipilih maupun disalin.

• class (opsional) adalah sebuah nama kelas CSS untuk kolom form HTML-nya.

• format (opsional) adalah format tanggal yang akan dipakai. Format ini digunakan oleh PHP untuk menentukan format string tanggal (lihat bawah). Jika tidak ada argumen, maka diasumsikan '%Y-%m-%d' (membuat tanggal menjadi seperti '2008-04-16').

• filter (opsional) adalah zona waktu yang dipakai. Ada dua nilai; server_utc dan user_utc. Yang pertama adalah zona waktu berbasis server dan yang kedua adalah zona waktu pengguna seperti yang dikonfigurasikan di dalam konfigurasi global dan informasi pengguna bersangkutan.
• translateformat (optional): If set to true, the calendar will use the DATE_FORMAT_CALENDAR_DATE language key (if showtime is true) or DATE_FORMAT_CALENDAR_DATETIME (if showtime is false) to determine the format. The format attribute is ignored. If false, the format attribute is used (same behaviour as prior to 3.7.0) but note that the format string must include time fields for the time to be recorded. Defaults to false.
• showtime (optional): If set to true and translateformat is true, the language key DATE_FORMAT_CALENDAR_DATETIME is used, otherwise DATE_FORMAT_CALENDAR_DATE. (starting with 3.7.0). Defaults to false.

• timeformat (optional): can be set to 12 or 24 (starting with 3.7.0). If set to 12, an additional selection is available to the user to choose between AM and PM. This attribute does not affect how the date/time is saved. Defaults to 24.

• singleheader (optional): if set to false, the year and the month selection will be set on two separates lines, with independent selection (starting with 3.7.0). Defaults to false.

• todaybutton (optional): if set to true, a button is added at the bottom of the date picker to select the date of the current day (starting with 3.7.0). Defaults to true.

• weeknumbers (optional): if set to true, a column is added at the left of the date picker to display the number of the week in the current year (starting with 3.7.0). Defaults to true.

• filltable (optional): if set to true, dates of the previous and next month are added at the top and bottom of the current month to fill the grid (starting with 3.7.0). Defaults to true.

• minyear (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user cannot select a year before this limit (starting with 3.7.0). If zero, which is the default, there is no limit.

• maxyear (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user cannot select a year after this limit (starting with 3.7.0). If zero, which is the default, there is no limit.

Contoh definisi kolom XML:

<field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description=""
	class="input-small" required="true" filter="user_utc"
	showtime="false" todaybutton="false" filltable="false" translateformat="true" />

Example for an advanced DatePicker XML field definition:

<field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description=""
	class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d %H:%M:%S"
	singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
	filltable="true" minyear="-3" maxyear="5" />

Atribut format menentukan format dimana string tanggal akan disimpan. Ini juga merupakan format yang diperlukan oleh tanggal untuk dimasukkan secara manual; kecuali karakter tanda baca yang akan diabaikan. Skema pengkodean yang dipakai untuk menentukan format-format tanggal adalah kustom yang didefinisikan untuk pustaka javascript yang dipakai di dalam datepicker, untuk detail selengkapnya silahkan lihat contoh di Github Joomla. Berikut adalah beberapa kode string tanggal yang biasa digunakan:

Karakter	Deskripsi	Contoh
d	Hari dalam bulan, 2 digit diawali nol	01 sampai 31
a	Perwakilan tekstual hari, tiga huruf	Sen sampai Min
e	Hari dalam bulan tanpa diawali nol	1 sampai 31
A	Perwakilan tekstual hari dalam mingguan	Senin sampai Minggu
w	Perwakilan angka hari dalam mingguan	0 (untuk Minggu) sampai 6 (untuk Sabtu)
j	Hari dalam tahun (dimulai dari 0)	001 sampai 366
B	Perwakilan tekstual lengkap dalam bulan	Januari sampai Desember
m	Perwakilan angka dalam bulan, dengan diawali nol	01 sampai 12
b	Perwakilan tekstual pendek bulan, tiga huruf	Jan sampai Des
Y	Perwakilan angka lengkap tahun, 4 digit	1999 atau 2003
y	Perwakilan dua digit tahun	99 atau 03
P	Huruf kecil Ante Meridiem atau Post Meridiem	am atau pm
p	Huruf kapital Ante Meridiem atau Post Meridiem	AM atau PM

Catat: Format dimana tanggal disimpan di dalam berkas params.ini ditentukan oleh argumen format. Disebabkan adanya elemen-elemen dependensi-bahasa terhadap format ini (sebagai contoh, penentu '%A'), maka Anda perlu berhati-hati untuk tidak memakai elemen seperti itu apabila ada kemungkinan dimana bahasa frontend maupun backend mungkin saja bisa berbeda.

Catat: Jenis kolom form Kalender tidak mendukung kalender non-Gregorian. Jika Anda perlu dukungan kalender non-Gregorian maka Anda harus membuat sebuah jenis kolom form kustom untuk mendukung kalender Anda tersebut.

Filter terkait standar

• user_utc - Menghitung nilai yang ditentukan ke waktu Greenwich, berdasarkan pada setelan zona waktu pengguna itu.

Lihat juga

• Daftar jenis kolom form standar