Ini adalah sebuah subhalamandokumentasi untuk Templat:Dts. Templat ini berisi informasi penggunaan, kategori dan konten lainnya yang bukan merupakan bagian dari templat halaman.
Templat ini digunakan pada sekitar28.000 halaman dan perubahannya kemungkinan memicu perubahan massal pada semua halaman yang menggunakannya. Uji cobalah di subhalaman /bak pasir atau /kasus uji Templat:Dts, atau subhalaman pengguna Anda. Pertimbangkan untuk mendiskusikan perubahan di halaman pembicaraan sebelum mengimplementasikannya.
Periksa apakah Anda benar-benar membutuhkan template ini sebelum menggunakannya. Penyortiran tanggal default tidak berfungsi untuk kombo bulan-tahun atau tahun-bulan yang dieja dan tanggal sebelum tahun 100, tetapi berfungsi di sebagian besar keadaan lainnya. Untuk informasi lebih lanjut, lihat Help:Sorting §Date sorting problems.
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
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.
Secara langsung memasukkan nama bulan yang disingkat.
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.
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
Bawaan
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.
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)
