Templat:Tarikh akhir/doc

Ini ialah sublaman pendokumenan untuk Templat:Tarikh akhir.
Ia mempunyai maklumat penggunaan, kategori dan kandungan lain yang bukan sebahagian daripada laman templat templat laman.

Penggunaan

Tujuan templat {{tarikh akhir}} ialah untuk menyatakan tarikh (atau tarikh dan masa) sesuatu peristiwa atau entiti berakhir atau dibubarkan. 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., "selepas 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 akhir|tahun|bulan|hari}}
{{tarikh akhir|TTTT|BB|HH}}
{{tarikh akhir|tahun|bulan|hari|jam|minit|saat|zonmasa}}
{{tarikh akhir|TTTT|BB|HH|JJ|MM|SS|zonmasa}}

(MM dan SS adalah pilihan; zonmasa mungkin nilai berangka, atau "Z" bagi UTC; lihat contoh)

Contoh

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

Parameter

Tarikh sesuatu peristiwa atau entiti berakhir atau dibubarkan

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	`df` `td` `tarikh dahulu`	Parameter boolean untuk meletakkan bilangan hari sebelum nama bulan. (HH BBBB TTTT) = format lalai. Nilai auto `ya`	Baris	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.

Penggunaan dalam microformat

Templat:UF-date-part