Templat:Tarikh mula/doc

Penggunaan

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

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

• {{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 (1993)"
• {{tarikh mula|1993|02}} → "Februari 1993 (1993-02)"
• {{tarikh mula|1993|02|24}} → "24 Februari 1993 (1993-02-24)"
• {{tarikh mula|1993|02|24|08|30}} → "08:30, 24 Februari 1993 (1993-02-24T08:30)"
• {{tarikh mula|1993|02|24|08||| 01:00}} → "24 Februari 1993 ( 01:00) (1993-02-24T08 01:00)"
• {{tarikh mula|1993|02|24|08|||-07:00}} → "24 Februari 1993 (-07:00) (1993-02-24T08-07:00)"
• {{tarikh mula|1993|02|24|08|30|23}} → "08:30:23, 24 Februari 1993 (1993-02-24T08:30:23)"
• {{tarikh mula|1993|02|24|08|30|23|Z}} → "08:30:23, 24 Februari 1993 (UTC) (1993-02-24T08:30:23Z)"
• {{tarikh mula|1993|02|24|08|30|23| 01:00}} → "08:30:23, 24 Februari 1993 ( 01:00) (1993-02-24T08:30:23 01:00)"
• {{tarikh mula|1993|02|24|08|30|23|-07:00}} → "08:30:23, 24 Februari 1993 (-07:00) (1993-02-24T08:30:23-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 (1993-02-24)"
• {{tarikh mula|1993|02|24|08|30|bd=ya}} → "08:30, Februari 24, 1993 (1993-02-24T08:30)"

Parameter

Tarikh sesuatu peristiwa atau entiti bermula atau dibuat

Parameter templat

Parameter		Keterangan	Jenis	Status
tahun	1	Bilangan tahun, dalam format empat digit. Contoh 1979	Angka	diperlukan
bulan	2	Bilangan bulan, dalam format dua digit. Contoh 01	Angka	pilihan
hari	3	Bilangan hari, dalam format dua digit. Contoh 01	Angka	pilihan
jam	4	Bilangan jam, dalam format dua digit 24-jam. Contoh 00, 23	Angka	pilihan
minit	5	Bilangan minit, dalam format dua digit. Contoh 00, 59	Angka	pilihan
saat	6	Bilangan saat, dalam format dua digit. Contoh 00, 59	Angka	pilihan
zon masa	7	Offset zon masa, “ 02:00”, “-06:00” atau “Z” untuk UTC. Contoh 08:00	Baris	pilihan
bulan didahulukan	bd	Parameter boolean untuk meletakkan nama bulan sebelum bilangan hari. (BBBB HH, TTTT) Contoh ya, y Nilai auto tidak	Baris	pilihan
tarikh didahulukan	td	Parameter boolean untuk meletakkan bilangan hari sebelum nama bulan. (HH BBBB TTTT) = format lalai. Nilai auto ya	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

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.

Lihat juga

• {{tarikh mula dan umur}}
• {{tarikh akhir}}
• {{tarikh mula dan akhir}}