smarty/docs/id/designers/language-custom-functions/language-function-html-select-date.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="language.function.html.select.date">
 <title>{html_select_date}</title>
  <para>
   <varname>{html_select_date}</varname> adalah
   <link linkend="language.custom.functions">fungsi kustom</link>
   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 <literal>&lt;select&gt;</literal> hari,
  bulan dan tahun.
 </para>

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

 <note>
  <para>
   Ada fungsi php berguina pada 
   <link linkend="tips.dates">halaman tips tanggal</link> untuk mengubah
   nilai bentuk <varname>{html_select_date}</varname> ke cap wantu.
  </para>
 </note>

 <example>
  <title>{html_select_date}</title>
  <para>Kode template</para>
  <programlisting>
<![CDATA[
{html_select_date}
]]>
  </programlisting>
  <para>
   Ini akan memperlihatkan:
  </para>
  <screen>
<![CDATA[
<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>
]]>
  </screen>
 </example>

 <example>
  <title>contoh kedua {html_select_date}</title>
  <programlisting>
<![CDATA[
{* 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}
]]>
  </programlisting>
  <para>
   Dengan  2000 sebagai tahun sekarang outputnya:
  </para>
  <screen>
<![CDATA[
<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>
]]>
  </screen>
 </example>
 <para>
  Lihat juga
  <link linkend="language.function.html.select.time"><varname>{html_select_time}</varname></link>,
  <link linkend="language.modifier.date.format"><varname>date_format</varname></link>,
  <link linkend="language.variables.smarty.now"><parameter>$smarty.now</parameter></link>
  dan the <link linkend="tips.dates">halaman tips tanggal</link>.
 </para>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->