Penggunaan sunting

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 sunting

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 sunting

(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 sunting

Tarikh sesuatu peristiwa atau entiti berakhir atau dibubarkan

Parameter templat

ParameterKeteranganJenisStatus
tahun1

Bilangan tahun, dalam format empat digit.

Contoh
1979
Angkadiperlukan
bulan2

Bilangan bulan, dalam format dua digit.

Contoh
01
Angkapilihan
hari3

Bilangan hari, dalam format dua digit.

Contoh
01
Angkapilihan
jam4

Bilangan jam, dalam format dua digit 24-jam.

Contoh
00, 23
Angkapilihan
minit5

Bilangan minit, dalam format dua digit.

Contoh
00, 59
Angkapilihan
saat6

Bilangan saat, dalam format dua digit.

Contoh
00, 59
Angkapilihan
zon masa7

Offset zon masa, “+02:00”, “-06:00” atau “Z” untuk UTC.

Contoh
+08:00
Barispilihan
bulan didahulukanbd

Parameter boolean untuk meletakkan nama bulan sebelum bilangan hari. (BBBB HH, TTTT)

Contoh
ya, y
Nilai auto
tidak
Barispilihan
tarikh didahulukandf td tarikh dahulu

Parameter boolean untuk meletakkan bilangan hari sebelum nama bulan. (HH BBBB TTTT) = format lalai.

Nilai auto
ya
Barisusang

Pembatasan sunting

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

Templat:UF-date-part

Lihat juga sunting