{html_select_date}

{html_select_date} adalah fungsi kustom yang membuat dropdown tanggal. Ia bisa menampilkan setiap atau seluruh tahun, bulan, dan hari. Semua parameter yang tidak dalam dafrar di bawah ini dicetak sebagai pasangan nama/nilai di dalam tag <select> hari, bulan dan tahun.

Nama Atribut	Tipe	Diperlukan	Default	Deskripsi
prefix	string	Tidak	Date_	Apa yang menjadi prefiks nama var
time	timestamp/ YYYY-MM-DD	Tidak	waktu dalam cap waktu unix atau format YYYY-MM-DD	Tanggal/jam apa yang dipakai
start_year	string	Tidak	tahun sekarang	Tahun pertama dalam dropdown, baik angka tahun, atau relatif ke tahun sekarang (+/- N)
end_year	string	Tidak	sama seperti start_year	Tahun terakhir dalam dropdown, baik angka tahun, atau relatif ke tahun sekarang (+/- N)
display_days	boolean	Tidak	`TRUE`	Apakan menampilkan hari atau tidak
display_months	boolean	Tidak	`TRUE`	Apakah menampilkan bulan atau tidak
display_years	boolean	Tidak	`TRUE`	Apakah menampilkan tahun atau tidak
month_format	string	Tidak	%B	Format apa seharusnya bulan ditampilkan dalam (strftime)
day_format	string	Tidak	%02d	Format apa hari seharusnya ditampilkan dalam (sprintf)
day_value_format	string	Tidak	%d	Format apa nilai hari seharusnya ditampilkan dalam (sprintf)
year_as_text	boolean	Tidak	`FALSE`	Apakah menampilkan tahun sebagai teks
reverse_years	boolean	Tidak	`FALSE`	Menampilkan tahun dalam urutan terbalik
field_array	string	Tidak	null	Jika nama diberikan, kotak pilih akan ditampilkan agar hasil akan dikembalikan ke PHP dalam bentuk name[Day], name[Year], name[Month].
day_size	string	Tidak	null	Menambahkan atribut size untuk memilih tag jika disediakan
month_size	string	Tidak	null	Menambahkan atribut size untuk memilih tag jika disediakan
year_size	string	Tidak	null	Menambahkan atribut size untuk memilih tag jika dsediakan
all_extra	string	Tidak	null	Menambahkan atribut ekstra ke semua tag select/input jika disediakan
day_extra	string	Tidak	null	Menambahkan atribut ekstra untuk tag select/input jika disediakan
month_extra	string	Tidak	null	Menambahkan atribut ekstra untuk tag select/input jika disediakan
year_extra	string	Tidak	null	Menambahkan atribut ekstra untuk tag select/input jika disediakan
field_order	string	Tidak	MDY	Urutan untuk menampilkan field
field_separator	string	Tidak	\n	String dicetak diantara field yang berbeda
month_value_format	string	Tidak	%m	format strftime() dari nilai bulan, standarnya adalah %m untuk angka bulan.
year_empty	string	Tidak	null	Jika disediakan maka elemen pertama dari kotak-pilih tahun memiliki nilai ini sebagai labelnya dan "" sebagai nilainya. Ini berguna untuk menjadikan kotak-select membaca "Please select a year" sebagai contoh. Catatan bahwa anda bisa memakai nilai seperti "-MM-DD" sebagai atribut-waktu untuk menunjukan tahuun yang tidak dipilih.
month_empty	string	Tidak	null	Jika disediakan maka elemen pertama dari kotak-pilih bulan memiliki nilai ini sebagai labelnya dan "" sebagai nilainya. Catatan bahwa anda dapat memakai nilai seperti "YYYY--DD" sebagai atribut-waktu untuk menunjukan bulan yang tidak dipilih.
day_empty	string	Tidak	null	Jika disediakan maka elemen pertama dari kotak-pilih hari memiliki nilai ini sebagai labelnya dan "" sebagai nilainya. Catatan bahwa anda dapat memakai nilai seperti "YYYY-MM-" sebagai atribut-waktu untuk menunjukan hari yang tidak dipilih.

Catatan: Ada fungsi php berguina pada halaman tips tanggal untuk mengubah nilai bentuk {html_select_date} ke cap wantu.

Teladan 8-19. {html_select_date}

Kode template

{html_select_date}

Ini akan memperlihatkan:

<select name="Date_Month">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
  ..... snipped .....
<option value="10">October</option>
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="Date_Day">
<option value="1">01</option>
<option value="2">02</option>
<option value="3">03</option>
  ..... snipped .....
<option value="11">11</option>
<option value="12">12</option>
<option value="13" selected="selected">13</option>
<option value="14">14</option>
<option value="15">15</option>
  ..... snipped .....
<option value="29">29</option>
<option value="30">30</option>
<option value="31">31</option>
</select>
<select name="Date_Year">
<option value="2006" selected="selected">2006</option>
</select>

Teladan 8-20. contoh kedua {html_select_date}

{* awal dan akhir tahun bisa relatif ke tahun saat ini *}
{html_select_date prefix='StartDate' time=$time start_year='-5'
   end_year='+1' display_days=false}

Dengan 2000 sebagai tahun sekarang outputnya:

<select name="StartDateMonth">
<option value="1">January</option>
<option value="2">February</option>
.... snipped ....
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="StartDateYear">
<option value="1995">1995</option>
.... snipped ....
<option value="1999">1999</option>
<option value="2000" selected="selected">2000</option>
<option value="2001">2001</option>
</select>

Lihat juga {html_select_time}, date_format, $smarty.now dan the halaman tips tanggal.

	Friday, August 08, 2008
	download \| documentation \| faq \| forum \| mailing lists \| changelog \| contribs

search for in the