आकृति:Date table sorting
This template is used on approximately २८,००० pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page before implementing them. |
Please check that you do actually need this template before using it. Default date sorting does not work for spelled-out month–year or year–month combos and dates before the year 100, but it works in most other circumstances. For more information, see Help:Sorting § Date sorting problems. |
This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see COinS in Wikipedia. |
This template uses Lua: |
Date table sorting is used to correctly sort and display dates in a sortable table (see Help:Sorting).
What it solves
[सम्पादन करी]Dates in their customary formats, if simply treated as alphanumeric text strings, sort in nonsensical ways:
- 1 September 1998 sorts alphanumerically before 5 March 1967, because 1 is less than 5;
- February 5, 1922 sorts alphanumerically before January 3, 1922, because F comes before J.
Use of the YYYY-MM-DD format would solve this problem, but with minor exceptions that format is not used in articles (see WP:DATEFORMAT).
This template automatically attaches a "hidden key" to dates, causing them to sort correctly while still being displayed in one of the customary display formats such as February 5, 1922 or 5 Feb 1922.
Parameters
[सम्पादन करी]Dates
[सम्पादन करी]{{Date table sorting|year|month|day|BC}} | {{Date table sorting|date}} |
---|---|
|
|
input style | input code | hidden sort key | visible output |
---|---|---|---|
{{Date table sorting|year}} | {{Date table sorting|1893}}
|
१८९३ | |
{{Date table sorting|-89}}
|
८९ BC | ||
{{Date table sorting|-10000}}
|
१०,००० BC | ||
{{Date table sorting|-1}}
|
१ BC | ||
{{Date table sorting| 1}}
|
१ (Note that year 0 does not exist and gives error message) | ||
{{Date table sorting|month}} | {{Date table sorting|Oct}}
|
अक्टुबर | |
{{Date table sorting|month year}} | {{Date table sorting|February 1767}}
|
फरबरी १७६७ | |
{{Date table sorting|day month year}} | {{Date table sorting|12 Aug 1987}}
|
१२ अगस्त १९८७ | |
{{Date table sorting|month day, year}} | {{Date table sorting|July 1, 1867}}
|
जुलाई १, १८६७ | |
{{Date table sorting|day month}} | {{Date table sorting|25 October}}
|
२५ अक्टुबर | |
{{Date table sorting|month day}} | {{Date table sorting|Jan 1}}
|
जनवरी १ | |
{{Date table sorting|YYYY-MM-DD}} | {{Date table sorting|2014-12-09}}
|
दिसम्बर ९, २०१४ | |
{{Date table sorting|DD-MM-YYYY}} | {{Date table sorting|15-05-2019}}
|
१५ मई २०१९ | |
{{Date table sorting|year|month}} | {{Date table sorting|1990|10}}
|
अक्टुबर १९९० | |
{{Date table sorting|1980|Dec}}
|
दिसम्बर १९८० | ||
{{Date table sorting|1970|August}}
|
अगस्त १९७० | ||
{{Date table sorting|year|month|day}} | {{Date table sorting|2024|Jun|12}}
|
जुन १२, २०२४ | |
{{Date table sorting|-204|11|22}}
|
नवम्बर २२, २०४ BC | ||
{{Date table sorting|year|month|day|era}} | {{Date table sorting|44|3|15|BC}}
|
मार्च १५, ४४ BC | |
{{Date table sorting|94|Oct|17|AD}}
|
अक्टुबर १७, ९४ | ||
{{Date table sorting||month}} | {{Date table sorting||May}}
|
मई | |
{{Date table sorting||month|day}} | {{Date table sorting||Sep|12}}
|
सितम्बर १२ |
Formatting
[सम्पादन करी]Using format
produces a format that depends on, but is not necessarily equal to the format of the supplied date. The format
parameter can take nine values.
value | function | input code | hidden sort key | visible output |
---|---|---|---|---|
format depends on the input | {{Date table sorting|26 Jan 1788}}
|
२६ जनवरी १७८८ | ||
{{Date table sorting|March 12, 1557}}
|
मार्च १२, १५५७ | |||
{{Date table sorting|1975-02-13}}
|
फरबरी १३, १९७५ | |||
dmy |
displays the date in day-month-year format | {{Date table sorting|Sep 13, 1888|format=dmy}}
|
१३ सितम्बर १८८८ | |
{{Date table sorting|1983-01-03|format=dmy}}
|
३ जनवरी १९८३ | |||
dm |
displays only the day and month in day-month format | {{Date table sorting|Feb 26, 1788|format=dm}}
|
२६ फरबरी | |
{{Date table sorting|2020-10-15|format=dm}}
|
१५ अक्टुबर | |||
mdy |
displays the date in month-day-year format | {{Date table sorting|August 31, 1901|format=mdy}}
|
अगस्त ३१, १९०१ | |
{{Date table sorting|2006-11-08|format=mdy}}
|
नवम्बर ८, २००६ | |||
md |
displays only the day and month in month-day format | {{Date table sorting|26 Jun 1988|format=md}}
|
जुन २६ | |
{{Date table sorting|2002-02-27|format=md}}
|
फरबरी २७ | |||
my |
displays only the month and year in month-year format | {{Date table sorting|16 November 1488|format=my}}
|
नवम्बर १४८८ | |
d |
displays only the day | {{Date table sorting|6 July 1666|format=d}}
|
६ | |
m |
displays only the month | {{Date table sorting|1980-02-12|format=m}}
|
फरबरी | |
y |
displays only the year | {{Date table sorting|-26|Jan|18|format=y}}
|
२६ BC | |
hide |
hides the date | {{Date table sorting|15 October 1800|format=hide}}
|
Abbreviation
[सम्पादन करी]There are two ways of abbreviating the month name.
- Directly input an abbreviated month name.
- Use the
abbr=on
parameter.
abbreviation method | input code | hidden sort key | visible output |
---|---|---|---|
none | {{Date table sorting|2000-01-01}}
|
जनवरी १, २००० | |
{{Date table sorting|2000|1|1}}
|
जनवरी १, २००० | ||
{{Date table sorting|1 January 2000}}
|
१ जनवरी २००० | ||
{{Date table sorting|2000|January|1}}
|
जनवरी १, २००० | ||
abbreviated input | {{Date table sorting|1 Jan 2000}}
|
१ जनवरी २००० | |
{{Date table sorting|2000|Jan|1}}
|
जनवरी १, २००० | ||
abbr=on |
{{Date table sorting|1 January 2000|abbr=on}}
|
१ जनवरी २००० | |
{{Date table sorting|2000|January|1|abbr=on}}
|
जनवरी १, २००० | ||
{{Date table sorting|2000-01-01|abbr=on}}
|
जनवरी १, २००० | ||
{{Date table sorting|2000|1|1|abbr=on}}
|
जनवरी १, २००० |
Additional sort key
[सम्पादन करी]In case two dates in a table are identical they may be ordered using the addkey
parameter.
input code | hidden sort key | visible output |
---|---|---|
{{Date table sorting|2010-10-10|addkey=3}}
|
अक्टुबर १०, २०१० | |
{{Date table sorting|2010-10-09}}
|
अक्टुबर ९, २०१० | |
{{Date table sorting|2010-10-10|addkey=1}}
|
अक्टुबर १०, २०१० | |
{{Date table sorting|2010-10-10}}
|
अक्टुबर १०, २०१० | |
{{Date table sorting|2010-10-10|addkey=4}}
|
अक्टुबर १०, २०१० | |
{{Date table sorting|2010-10-11}}
|
अक्टुबर ११, २०१० | |
{{Date table sorting|2010-10-10|addkey=2}}
|
अक्टुबर १०, २०१० |
Wrapping
[सम्पादन करी]To turn off the suppression of word wraps, use the nowrap=off
parameter.
TemplateData
[सम्पादन करी]Date table sorting is used to correctly sort and display dates in a sortable table.
पैरामीटर | विवरण | प्रकार | स्थिति | |
---|---|---|---|---|
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.
| स्ट्रिंग | वैकल्पिक |
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.
| स्ट्रिंग | वैकल्पिक |
Day | 3 | Day, optionally zero-padded
| संख्या | वैकल्पिक |
Era | 4 | BC, AD, BCE or CE. Takes effect only if the first parameter is a positive number. | स्ट्रिंग | वैकल्पिक |
Format | format | Controls the output format. Can be "dmy", "dm", "mdy", "md", "my", "d", "m", "y" or "hide". | स्ट्रिंग | वैकल्पिक |
Abbreviation | abbr | Abbreviates the month name
| स्ट्रिंग | वैकल्पिक |
Additional sort key | addkey | Adds another sort key to resolve conflicts between rows with the same date
| संख्या | वैकल्पिक |
Wrapping | nowrap | To turn off the suppression of word wraps, use the "off" parameter
| बूलियन | वैकल्पिक |
Notes
[सम्पादन करी]Sorting for incomplete dates
[सम्पादन करी]- Whole months or years
- A whole year or month (and year) is sorted according to its first day.
- Missing years
- If the year is not specified, the date will be sorted as if the year were the current year.
- Blank dates
- For no date input at all, the maximum possible sort key is used, so the entry will sort last.
Error handling
[सम्पादन करी]Errors are tracked in Category:Date table sorting templates with errors.
Calendar choice
[सम्पादन करी]The template is not capable of distinguishing Julian and Gregorian calendar dates. Also, it is not capable of taking a date in one calendar as input and outputting a date in the other calendar. Thus, to insure proper sorting, editors must either use one calendar for all dates, or pick a specific changeover date (for example, deciding that 4 October 1582 is Julian and all later dates are Gregorian); this would be done on an article-by article basis. Editors are also responsible for explaining to the reader whether the visible dates are Julian or Gregorian, if there is any possibility of confusion.
Linking
[सम्पादन करी]The template formerly linked dates automatically, with link=off
used to suppress linking. In accordance with current guidelines linking of dates is no longer supported and instances of link=off
should be removed.
See also
[सम्पादन करी]- {{sort}}, sorting by a specified key (also good for complicated numbers, e.g. scientific notation)
- {{sortname}}, full name sorting (using "last name, first name" as default sort key)
- {{tts}}, for sorting times in result tables of athletic events (only needed in certain cases - see template documentation)
- {{Number table sorting}}, for numbers
The above documentation is transcluded from आकृति:Date table sorting/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |