Penggunaan

sunting

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

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

(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

sunting

Tarikh sesuatu peristiwa atau entiti bermula atau dibuat

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 didahulukantd

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

Nilai auto
ya
Barisusang
umurumur

Parameter untuk memaparkan umur di belakang tarikh. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini.

Booleanusang
kurungankurungan

Parameter untuk memaparkan umur di belakang tarikh dalam kurungan. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini.

Booleanusang
langkau barisbr

Parameter untuk memaparkan umur di satu barisan bawah tarikh. Dikeluarkan. Sila guna {{tarikh mula dan umur}} untuk fungsi ini.

Booleanusang

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