Templat:Tarikh mula dan umur/doc

Penggunaan

Tujuan templat {{tarikh mula dan umur}} adalah untuk menyatakan tarikh sesuatu peristiwa atau entiti bermula atau dicipta dan juga panjang masa tarikh tersebut hingga hari ini. 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.

Sintaks

Format tarikh lalai templat ini adalah HARI BULAN TAHUN. Format tarikh BHT iaitu BULAN HARI, TAHUN boleh digunakan dengan parameter bd (bulan didahulukan) atau mf (month first).

Sintaks penuh

{{Tarikh mula dan umur|yyyy|mm|dd|bd=yes|kurungan=yes|baris=yes|end=yes}}

atau

{{Tarikh mula dan umur|yyyy|mm|dd|bd=yes|kr=yes|br=yes|end=yes}}

Penggunaan format tarikh lain

{{Tarikh mula dan umur|2010|03|04}} untuk memaparkan pendapatan dalam format 4 Mac 2010; 14 tahun yang lalu (2010-03-04).
{{Tarikh mula dan umur|2010|03|04|bd=y}} untuk memaparkan pendapatan dalam format Mac 4, 2010; 14 tahun yang lalu (2010-03-04).

Parameter

Tarikh sesuatu peristiwa atau entiti bermula atau dibuat serta panjang masa tarikh tersebut hingga hari ini.

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, 12	Angka	pilihan
hari	`3`	Bilangan hari, dalam format dua digit. Contoh 01, 31	Angka	pilihan
bulan didahulukan	`bd` `mf`	Parameter boolean untuk meletakkan nama bulan sebelum bilangan hari. (BBBB HH, TTTT) Contoh yes, y, 1 Nilai auto `tidak`	Boolean	pilihan
kurungan	`kr` `kurungan` `p` `paren`	Parameter boolean untuk meletakkan umur dalam kurungan. Contoh yes, y, 1	Boolean	pilihan
langkau baris	`br` `baris`	Parameter untuk memaparkan umur di satu barisan bawah tarikh. Titik koma akan memisahkan tarikh dan umur sebelum garis putus atau ruang kosong. Contoh yes, y, 1	Boolean	pilihan
mikroformat	`end`	Mikroformat tersembunyi <span class = "bday dtstart published updated"> akan ditukarkan kepada <span class = "dtend"> jika ditetapkan sebagai yes, y, atau 1. Contoh yes, y, 1	Boolean	pilihan

Contoh

Pemisah lalai: titik koma

Sintaks	Pendapatan
Tarikh penuh (tahun, bulan, hari)
`{{Tarikh mula dan umur\|2010\|01\|02}}`	2 Januari 2010; 14 tahun yang lalu (2010-01-02)
`{{Tarikh mula dan umur\|2008\|Jan\|09\|hd=yes}}`	9 Januari 2008; 16 tahun yang lalu (2008-01-09)
`{{Tarikh mula dan umur\|2003\|January\|05\|bd=no}}`	5 Januari 2003; 21 tahun yang lalu (2003-01-05)
`{{Tarikh mula dan umur\|2010\|1\|2\|bd=yes}}`	Januari 2, 2010; 14 tahun yang lalu (2010-01-02)
`{{Tarikh mula dan umur\|2008\|Jan\|9\|mf=y}}`	Januari 9, 2008; 16 tahun yang lalu (2008-01-09)
`{{Tarikh mula dan umur\|2003\|January\|5\|mf=1}}`	Januari 5, 2003; 21 tahun yang lalu (2003-01-05)
100 hari yang lalu: `{{Tarikh mula dan umur\|2024\|8\|23}}`	23 Ogos 2024; 3 bulan yang lalu (2024-08-23)
Hari semalam: `{{Tarikh mula dan umur\|2024\|11\|30}}`	30 November 2024; 1 hari yang lalu (2024-11-30)
Hari ini: `{{Tarikh mula dan umur\|2024\|12\|1}}`	1 Disember 2024; 0 hari yang lalu (2024-12-01)
Tahun dan bulan
`{{Tarikh mula dan umur\|2001\|9}}`	September 2001; 23 tahun yang lalu (2001-09)
`{{Tarikh mula dan umur\|2002\|09}}`	September 2002; 22 tahun yang lalu (2002-09)
`{{Tarikh mula dan umur\|2003\|Sep}}`	September 2003; 21 tahun yang lalu (2003-09)
`{{Tarikh mula dan umur\|2004\|September}}`	September 2004; 20 tahun yang lalu (2004-09)
Tahun sahaja
`{{Tarikh mula dan umur\|2005}}`	2005; 19 tahun yang lalu (2005)

Pemisah pilihan: kurungan

Sintaks	Pendapatan
Tarikh penuh (tahun, bulan, hari)
`{{Tarikh mula dan umur\|2003\|02\|15\|kurungan=yes}}`	15 Februari 2003 (21 tahun yang lalu) (2003-02-15)
`{{Tarikh mula dan umur\|2003\|02\|15\|bd=y\|kr=y}}`	Februari 15, 2003 (21 tahun yang lalu) (2003-02-15)
Tahun dan bulan
`{{Tarikh mula dan umur\|2003\|02\|kurungan=1}}`	Februari 2003 (21 tahun yang lalu) (2003-02)
Tahun sahaja
`{{Tarikh mula dan umur\|2003\|paren=yes}}`	2003 (21 tahun yang lalu) (2003)

Tukar baris dengan titik koma

Sintaks	Pendapatan
Tarikh penuh (tahun, bulan, hari)
`{{Tarikh mula dan umur\|2003\|02\|15\|baris=yes}}`	15 Februari 2003; 21 tahun yang lalu (2003-02-15)
`{{Tarikh mula dan umur\|2003\|02\|15\|bd=y\|br=y}}`	Februari 15, 2003; 21 tahun yang lalu (2003-02-15)
Tahun dan bulan
`{{Tarikh mula dan umur\|2003\|02\|baris=1}}`	Februari 2003; 21 tahun yang lalu (2003-02)
Tahun sahaja
`{{Tarikh mula dan umur\|2003\|br=yes}}`	2003; 21 tahun yang lalu (2003)

Tukar baris dengan kurungan

Sintaks	Pendapatan
Tarikh penuh (tahun, bulan, hari)
`{{Tarikh mula dan umur\|2003\|02\|15\|kurungan=yes\|baris=yes}}`	15 Februari 2003 (21 tahun yang lalu) (2003-02-15)
`{{Tarikh mula dan umur\|2003\|02\|15\|bd=y\|kurungan=y\|br=y}}`	Februari 15, 2003 (21 tahun yang lalu) (2003-02-15)
Tahun dan bulan
`{{Tarikh mula dan umur\|2003\|02\|kr=1\|baris=1}}`	Februari 2003 (21 tahun yang lalu) (2003-02)
Tahun sahaja
`{{Tarikh mula dan umur\|2003\|paren=yes\|br=yes}}`	2003 (21 tahun yang lalu) (2003)