Templat:Dts/doc

Date table sorting digunakan untuk mengurutkan dan menampilkan tanggal dengan benar dalam tabel yang dapat diurutkan (lihat Help:Sorting).

Apa yang dipecahkan

Tanggal dalam format biasa, jika hanya diperlakukan sebagai string teks alfanumerik, urutkan dengan cara yang tidak masuk akal:

• 1 September 1998 diurutkan secara alfanumerik sebelum 5 Maret 1967, karena '1' kurang dari '5';
• 5 Februari 1922 mengurutkan secara alfanumerik sebelum 3 Januari 1922, karena 'F' muncul sebelum J .

Penggunaan format YYYY-MM-DD akan menyelesaikan masalah ini, tetapi dengan pengecualian kecil bahwa format tidak digunakan dalam artikel (lihat WP: FORMATTANGGAL)).

Kerangka ini secara otomatis melampirkan "kunci tersembunyi" ke tanggal, menyebabkan mereka menyortir dengan benar saat masih ditampilkan dalam salah satu format tampilan biasa seperti 5 Februari 1922 atau 5 Februari 1922 .

Parameter

Tanggal

Tahun, bulan, dan hari dapat dimasukkan secara terpisah atau sebagai satu tanggal.

{{Dts|tahun|bulan|hari|BC}}

{{Dts|tanggal}}

Parameter 1 - Tahun (opsional jika bulan diberikan) Angka positif (1 hingga 999.999.999.999) mewakili tahun AD atau BC (tergantung pada parameter keempat). Angka negatif (−1 hingga −999.999.999.999) mewakili tahun BC (tanpa parameter keempat). Nomor tahun tidak boleh mengandung koma atau pemformatan lainnya. Parameter 2 - Bulan (opsional jika hari itu tidak diberikan juga) Nama bulan penuh - mis. Februari Nama bulan disingkat - mis. Februari Nomor bulan - (baik yang berbantalan nol atau tidak) mis. 2 atau 02 Parameter ketiga - Hari (opsional) Nomor hari - (baik tanpa bantalan atau tidak) mis. 7 atau 07 Parameter 4 - (opsional) Mungkin BC, AD, SM atau CE Digunakan dengan angka tahun positif

Parameter 1 - tanggal penuh Secara default, format YYYY-MM-DD menjadi format bulan-hari-tahun dan format DD-MM-YYYY menjadi hari-bulan-tahun sementara format lain tetap dalam urutan yang mereka masukkan. Bulan disingkat diterima dan disingkat dalam output. Kapitalisasi dan kesalahan koma diperbaiki. Nomor tunggal ditafsirkan sebagai tahun, jika tidak, tanggal diuraikan oleh modul. Format berikut diterima: YYYY-MM-DD DD-MM-YYYY DD Bulan Bulan YYYY Bulan DD, YYYY YYYY-MM DD Bulan Bulan DD Bulan YYYY YYYY Bulan *** Angka hari dan bulan mungkin 1 atau 2 digit, dan angka tahun mungkin hanya 3 atau 4 digit. Jika Anda perlu memasukkan angka kurang dari 1000, gunakan nol nol terkemuka (mis. "0700"). SM tahun hanya dapat diuraikan jika tanggal hanya nomor tahun. Jika Anda perlu memasukkan hari atau bulan selama tahun SM atau lebih dari 9999, Anda harus menggunakan parameter terpisah untuk tahun, bulan dan hari.

+ Contoh	Gaya masukan	kode masukan!	Tombol sortir tersembunyi	Output yang terlihat
{{Dts|tahun}}	{{Date table sorting|1893}}	1893	1893
	{{Date table sorting|-89}}
	{{Date table sorting|-10000}}
{{Dts|month}}	{{Date table sorting|Okt}}	Okt	Okt
{{Dts|month year}}	{{Date table sorting|Februari 1767}}	Februari 1767	Februari 1767
{{Dts|day month year}}	{{Date table sorting|12 Agu 1987}}	12 Agu 1987	12 Agu 1987
{{Dts|month day, year}}	{{Date table sorting|Juli 1, 1867}}	Juli 1, 1867	Juli 1, 1867
{{Dts|day month}}	{{Date table sorting|25 Oktober}}	25 Oktober	25 Oktober
{{Dts|month day}}	{{Date table sorting|Jan 1}}	Jan 1	Jan 1
{{Dts|YYYY-MM-DD}}	{{Date table sorting|2014-12-09}}	2014-12-09	2014-12-09
{{Dts|DD-MM-YYYY}}	{{Date table sorting|15-05-2019}}	15-05-2019	15-05-2019
{{Dts|tahun|bulan}}	{{Date table sorting|1990|10}}	1990	1990
	{{Date table sorting|1980|Des}}	1980	1980
	{{Date table sorting|1970|Agustus}}	1970	1970
{{Dts|tahun|bulan|hari}}	{{Date table sorting|2024|Jun|12}}	2024	2024
	{{Date table sorting|-204|11|22}}
{{Dts|tahun|bulan|hari|era}}	{{Date table sorting|44|3|15|BC}}	44	44
	{{Date table sorting|94|Oct|17|AD}}	94	94
{{Dts||bulan}}	{{Date table sorting||Mei}}
{{Dts||bulan|hari}}	{{Date table sorting||Sep|12}}

Pemformatan

Gunakan format menghasilkan format yang bergantung pada, tetapi belum tentu sama dengan format tanggal yang diberikan. format Parameter dapat mengambil sembilan nilai.

Examples

value	function	input code	hidden sort key	visible output
	format depends on the input	{{Date table sorting|26 Jan 1788}}	26 Jan 1788	26 Jan 1788
		{{Date table sorting|Maret 12, 1557}}	Maret 12, 1557	Maret 12, 1557
		{{Date table sorting|1975-02-13}}	1975-02-13	1975-02-13
dmy	displays the date in day-month-year format	{{Date table sorting|Sep 13, 1888|format=dmy}}	Sep 13, 1888	Sep 13, 1888
		{{Date table sorting|1983-01-03|format=dmy}}	1983-01-03	1983-01-03
dm	displays only the day and month in day-month format	{{Date table sorting|Feb 26, 1788|format=dm}}	Feb 26, 1788	Feb 26, 1788
		{{Date table sorting|2020-10-15|format=dm}}	2020-10-15	2020-10-15
mdy	displays the date in month-day-year format	{{Date table sorting|Agustus 31, 1901|format=mdy}}	Agustus 31, 1901	Agustus 31, 1901
		{{Date table sorting|2006-11-08|format=mdy}}	2006-11-08	2006-11-08
md	displays only the day and month in month-day format	{{Date table sorting|26 Jun 1988|format=md}}	26 Jun 1988	26 Jun 1988
		{{Date table sorting|2002-02-27|format=md}}	2002-02-27	2002-02-27
my	displays only the month and year in month-year format	{{Date table sorting|16 November 1488|format=my}}	16 November 1488	16 November 1488
d	displays only the day	{{Date table sorting|6 Juli 1666|format=d}}	6 Juli 1666	6 Juli 1666
m	displays only the month	{{Date table sorting|1980-02-12|format=m}}	1980-02-12	1980-02-12
y	displays only the year	{{Date table sorting|-26|Jan|18|format=y}}
hide	hides the date	{{Date table sorting|15 Oktober 1800|format=hide}}	15 Oktober 1800	15 Oktober 1800

Singkatan

Ada dua cara untuk menyingkat nama bulan.

1. Secara langsung memasukkan nama bulan yang disingkat.
2. Gunakan parameter abbr=on.

Examples

abbreviation method	kode masukan	hidden sort key	visible output
none	{{Date table sorting|2000-01-01}}	2000-01-01	2000-01-01
	{{Date table sorting|2000|1|1}}	2000	2000
	{{Date table sorting|1 Januari 2000}}	1 Januari 2000	1 Januari 2000
	{{Date table sorting|2000|Januari|1}}	2000	2000
abbreviated input	{{Date table sorting|1 Jan 2000}}	1 Jan 2000	1 Jan 2000
	{{Date table sorting|2000|Jan|1}}	2000	2000
abbr=on	{{Date table sorting|1 Januari 2000|abbr=on}}	1 Januari 2000	1 Januari 2000
	{{Date table sorting|2000|Januari|1|abbr=on}}	2000	2000
	{{Date table sorting|2000-01-01|abbr=on}}	2000-01-01	2000-01-01
	{{Date table sorting|2000|1|1|abbr=on}}	2000	2000

Kunci sortir tambahan

Dalam hal dua tanggal dalam sebuah tabel identik mereka dapat dipesan menggunakan addkey parameter.

Contoh

kode masukan	tombol sortir tersembunyi	keluaran yang terlihat
{{Date table sorting|2010-10-10|addkey=3}}	2010-10-10	2010-10-10
{{Date table sorting|2010-10-09}}	2010-10-09	2010-10-09
{{Date table sorting|2010-10-10|addkey=1}}	2010-10-10	2010-10-10
{{Date table sorting|2010-10-10}}	2010-10-10	2010-10-10
{{Date table sorting|2010-10-10|addkey=4}}	2010-10-10	2010-10-10
{{Date table sorting|2010-10-11}}	2010-10-11	2010-10-11
{{Date table sorting|2010-10-10|addkey=2}}	2010-10-10	2010-10-10

Wrapping

Untuk mematikan penekanan penekanan kata, gunakan parameter nowrap=off parameter.

TemplateData

Date table sorting is used to correctly sort and display dates in a sortable table.

Parameter templat

Parameter		Keterangan	Jenis	Status
Full date or year	1	Full date if second to fourth parameters are not specfied, otherwise year. Full date can be either in "YYYY-MM-DD", "DD-MM-YYYY", "DD Month YYYY", "Month DD, YYYY", "YYYY-MM", "DD Month", "Month DD", "Month YYYY" or "Month" format. Year is either a positive number or a negative number. If fourth parameter is not specified negative numbers are interpreted as years of BC era. Parameter is optional if the second parameter is specified. Contoh "1893", "-89", "-10000", "Oct", "February 1767", "12 Aug 1987", "July 1, 1867", "25 October", "Jan 1", "2014-12-09"	Kata	opsional
Month	2	Full or abbreviated month name or alternatively, a month number which can be zero-padded. Parameter is optional if the third parameter is not specified. Contoh February, Feb, 2 or 02	Kata	opsional
Day	3	Day, optionally zero-padded Contoh 7 or 07	Angka	opsional
Era	4	BC, AD, BCE or CE. Takes effect only if the first parameter is a postive number.	Kata	opsional
Format	format	Controls the output format. Can be "dmy", "dm", "mdy", "md", "my", "d", "m", "y" or "hide".	Kata	opsional
Abbreviation	abbr	Abbreviates the month name Baku off Contoh on	Kata	opsional
Additional sort key	addkey	Adds another sort key to resolve conflicts between rows with the same date Contoh 3	Angka	opsional
Wrapping	nowrap	To turn off the suppression of word wraps, use the "off" parameter Contoh off	Kata	opsional

Catatan

Menyortir untuk tanggal yang tidak lengkap

Seluruh bulan atau tahun

Satu tahun penuh atau bulan (dan tahun) diurutkan berdasarkan hari pertama.

Tahun yang hilang

Jika tahun tidak ditentukan, tanggal akan disortir seolah-olah tahun itu adalah tahun berjalan.

Tanggal kosong

Tanpa masukan tanggal sama sekali, kunci sortir maksimum yang mungkin digunakan, sehingga entri akan diurutkan terakhir.

Penanganan kesalahan

Kesalahan dilacak dalam Kategori:Templat penyortiran tabel tanggal dengan kesalahan.

Pilihan kalender

Templat tidak dapat membedakan tanggal kalender Julian dan Gregorian. Selain itu, ia tidak dapat mengambil tanggal dalam satu kalender sebagai input dan output tanggal dalam kalender lainnya. Dengan demikian, untuk memastikan penyortiran yang tepat, editor harus menggunakan satu kalender untuk semua tanggal, atau memilih tanggal pergantian tertentu (misalnya, memutuskan bahwa 4 Oktober 1582 adalah Julian dan semua tanggal berikutnya adalah Gregorian); ini akan dilakukan berdasarkan artikel-demi artikel. Editor juga bertanggung jawab untuk menjelaskan kepada pembaca apakah tanggal yang terlihat adalah Julian atau Gregorian, jika ada kemungkinan kebingungan.

Menautkan

Templat yang sebelumnya ditautkan tanggal secara otomatis, dengan tautan link=off digunakan untuk menekan tautan. Sesuai dengan pedoman saat ini, penautan tanggal tidak lagi didukungdan contoh tautan link=off harus dihapus.

Lihat juga

• {{sort}}, menyortir dengan kunci tertentu (juga bagus untuk angka rumit, misalnya notasi ilmiah)
• {{sortname}}, penyortiran nama lengkap (menggunakan "nama belakang, nama depan" sebagai kunci sortir bawaan)
• {{tts}}, untuk waktu penyortiran dalam tabel hasil pertandingan atletik (hanya diperlukan dalam kasus tertentu - lihat dokumentasi templat)
• {{Number table sorting}}, untuk nomor