Templat:Tarikh mula/doc
 | Ini ialah sublaman pendokumenan untuk Templat:Tarikh mula. Ia mempunyai maklumat penggunaan, kategori dan kandungan lain yang bukan sebahagian daripada laman templat templat laman. |
Penggunaan[sunting sumber]
Tujuan templat {{tarikh mula}} ialah untuk menyatakan tarikh (atau tarikh dan masa) sesuatu peristiwa atau entiti bermula atau dicipta. Ini juga termasuk pendua, tarikh boleh dibaca mesin (atau tarikh dan masa) dalam format tarikh ISO (yang disembunyikan oleh CSS), untuk kegunaan dalam templat lain (atau baris jadual) yang memancarkan microformat. Ia sepatutnya digunakan hanya sekali dalam templat berkenaan dan tidak digunakan di luar templat tersebut. Tarikh yang tersembunyi didegradasikan apabila CSS tidak tersedia.
Bila bukan digunakan templat ini[sunting sumber]
Jangan gunakan templat ini untuk:
- tarikh yang tidak pasti e.g., "sebelum 4 April 1933"; "kira-kira 18 November 1939"
- tarikh di luar julat seperti dinyatakan di bawah "Pembatasan", di bawah
- tarikh sekunder, lain
- di luar templat yang mengeluarkan microformat - jika dalam keraguan, lihat pendokumenan templat induk
- lebih dari satu tarikh dalam apa sahaja templat
Sintaks[sunting sumber]
{{tarikh mula|tahun|bulan|hari}}{{tarikh mula|TTTT|BB|HH}}{{tarikh mula|tahun|bulan|hari|jam|minit|saat|zonmasa}}{{tarikh mula|TTTT|BB|HH|JJ|MM|SS|zonmasa}}
(MM dan SS adalah pilihan; zonmasa mungkin nilai berangka, atau "Z" bagi UTC; lihat contoh)
- Contoh
{{tarikh mula|1993}}→ "1993"{{tarikh mula|1993|02}}→ "Februari 1993"{{tarikh mula|1993|02|24}}→ "24 Februari 1993"{{tarikh mula|1993|02|24|08|30}}→ "08:30, 24 Februari 1993"{{tarikh mula|1993|02|24|08|||+01:00}}→ "24 Februari 1993 (+01:00)"{{tarikh mula|1993|02|24|08|||-07:00}}→ "24 Februari 1993 (-07:00)"{{tarikh mula|1993|02|24|08|30|23}}→ "08:30:23, 24 Februari 1993"{{tarikh mula|1993|02|24|08|30|23|Z}}→ "08:30:23, 24 Februari 1993 (UTC)"{{tarikh mula|1993|02|24|08|30|23|+01:00}}→ "08:30:23, 24 Februari 1993 (+01:00)"{{tarikh mula|1993|02|24|08|30|23|-07:00}}→ "08:30:23, 24 Februari 1993 (-07:00)"
Parameter pilihan, bd (bulan dahulu), boleh ditetapkan ke "y" atau "ya" (atau apa saja nilai) untuk memaparkan bulan sebelum hari. Ini terutamanya digunakan dalam rencana yang menggunakan format BULAN HARI, TAHUN untuk tarikh.
- Contoh
{{tarikh mula|1993|02|24|bd=y}}→ "Februari 24, 1993"{{tarikh mula|1993|02|24|08|30|bd=ya}}→ "08:30, Februari 24, 1993"
Parameter[sunting sumber]
Tarikh sesuatu peristiwa atau entiti bermula atau dibuat
| Parameter | Keterangan | Jenis | Status | |
|---|---|---|---|---|
| tahun | 1 | Bilangan tahun, dalam format empat digit.
| Angka | diperlukan |
| bulan | 2 | Bilangan bulan, dalam format dua digit.
| Angka | pilihan |
| hari | 3 | Bilangan hari, dalam format dua digit.
| Angka | pilihan |
| jam | 4 | Bilangan jam, dalam format dua digit 24-jam.
| Angka | pilihan |
| minit | 5 | Bilangan minit, dalam format dua digit.
| Angka | pilihan |
| saat | 6 | Bilangan saat, dalam format dua digit.
| Angka | pilihan |
| zon masa | 7 | Offset zon masa, “+02:00”, “-06:00” atau “Z” untuk UTC.
| Baris | pilihan |
| bulan didahulukan | bd | Parameter boolean untuk meletakkan nama bulan sebelum bilangan hari. (BBBB HH, TTTT)
| Baris | pilihan |
| tarikh didahulukan | td | Parameter boolean untuk meletakkan bilangan hari sebelum nama bulan. (HH BBBB TTTT) = format lalai.
| Baris | usang |
| umur | umur | Parameter untuk memaparkan umur di belakang tarikh. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini. | Boolean | usang |
| kurungan | kurungan | Parameter untuk memaparkan umur di belakang tarikh dalam kurungan. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini. | Boolean | usang |
| langkau baris | br | Parameter untuk memaparkan umur di satu barisan bawah tarikh. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini. | Boolean | usang |
Pembatasan[sunting sumber]
Templat ini tiada mempunyai peruntukan untuk menangani kalendar bukan Masihi. Juga, ISO 8601 memerlukan persetujuan bersama di antara yang bertukar maklumat sebelum menggunakan tahun di luar julat 1583-9999 CE. Oleh itu, pengunakan templat ini untuk tarikh bukan Masihi atau tarikh di luar julat tersebut merupakan pematuhan palsu kepada piawaian ISO 8601.
Mana-mana editor yang terjumpa penggunaan sedemikian hendaklah menukar tarikh tersebut ke teks biasa tanpa templat; atau jika tidak yakin untuk berbuat demikian, mengemukakan perkara tersebut pada halaman perbincangan templat ini.
Penggunaan dalam microformat[sunting sumber]
Lihat juga[sunting sumber]
- {{tarikh mula dan umur}}
- {{tarikh akhir}}
- {{tarikh mula dan akhir}}