blackwiki - User contributions [en]

Template:Date table sorting/doc

2019-07-22T16:01:50Z

98.31.29.4: A comes before M

{{Documentation subpage}}

{{High-use| 27900 }}
{{Mbox|type=content|text=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 {{Section link|Help:Sorting|Date sorting problems}}.}}
{{COinS safe|n}}
{{template shortcut|dts}}
{{lua|Module:Date table sorting}}

'''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===
{|class=wikitable
|-
|+The year, month and day can either be entered separately or as a single date.
|-
! style="width: 50%;" |{{tlf|{{BASEPAGENAME}}|''year''|''month''|''day''|''BC''}}
! style="width: 50%;" |{{tlf|{{BASEPAGENAME}}|''date''}}
|- style="vertical-align:top;"
|
* 1st parameter – Year (optional if month is given)
** Positive number (1 to 999,999,999,999) represent years AD or BC (dependant on the fourth parameter).
** Negative numbers (−1 to −999,999,999,999) represent years BC (without the fourth parameter).
** Year numbers must not contain commas or other formatting.
* 2nd parameter – Month (optional if the day is not given either)
** Full month name – e.g. February
** Abbreviated month name – e.g. Feb
** Month number – (either zero-padded or not) e.g. 2 or 02
* 3rd parameter – Day (optional)
** Day number – (either zero-padded or not) e.g. 7 or 07
* 4th parameter – (optional)
** May be BC, AD, BCE or CE
** Used with a positive year number
|
* 1st parameter – the full date
** By default YYYY-MM-DD format becomes month-day-year format and DD-MM-YYYY format becomes day-month-year while other formats remain in the order they are input.
** Abbreviated months are accepted and are abbreviated in the output.
** Capitalisation and comma mistakes are corrected.
** A single number is interpreted as a year, otherwise the date is parsed by the module. The following formats are accepted:
*** YYYY-MM-DD
*** DD-MM-YYYY
*** DD Month YYYY
*** Month DD, YYYY
*** YYYY-MM
*** DD Month
*** Month DD
*** Month YYYY
*** YYYY
*** Month
** Day and month numbers may be 1 or 2 digits, and year numbers may only be 3 or 4 digits. If you need to input a number less than 1000, use leading zeroes (e.g. "0700").
** BC years can only be parsed if the date is only the year number.
** If you need to include the day or month for BC years or years greater than 9999, you must use separate parameters for year, month and day.
|}

{| class="wikitable sortable"
|+ Examples
!input style
!input code
!hidden sort key
!visible output
{{{{BASEPAGENAME}}/testcases/row|span=3|a={{tlf|{{BASEPAGENAME}}|''year''}}|1893}}
{{{{BASEPAGENAME}}/testcases/row|-89}}
{{{{BASEPAGENAME}}/testcases/row|-10000}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''month''}}|Oct}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''month year''}}|February 1767}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''day month year''}}|12 Aug 1987}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''month day, year''}}|July 1, 1867}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''day month''}}|25 October}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''month day''}}|Jan 1}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''YYYY-MM-DD''}}|2014-12-09}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}|''DD-MM-YYYY''}}|15-05-2019}}
{{{{BASEPAGENAME}}/testcases/row|span=3|a={{tlf|{{BASEPAGENAME}}|''year''|''month''}}|1990|10}}
{{{{BASEPAGENAME}}/testcases/row|1980|Dec}}
{{{{BASEPAGENAME}}/testcases/row|1970|August}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a={{tlf|{{BASEPAGENAME}}|''year''|''month''|''day''}}|2024|Jun|12}}
{{{{BASEPAGENAME}}/testcases/row|-204|11|22}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a={{tlf|{{BASEPAGENAME}}|''year''|''month''|''day''|''era''}}|44|3|15|BC}}
{{{{BASEPAGENAME}}/testcases/row|94|Oct|17|AD}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}||''month''}}||May}}
{{{{BASEPAGENAME}}/testcases/row|a={{tlf|{{BASEPAGENAME}}||''month''|''day''}}||Sep|12}}
|}

===Formatting===
Using <code>format</code> produces a format that depends on, but is not necessarily equal to the format of the supplied date. The <code>format</code> parameter can take nine values.

{|class="wikitable sortable"
|+ Examples
|-
!value
!function
!input code
!hidden sort key
!visible output
{{{{BASEPAGENAME}}/testcases/row|span=3|a= |b=format depends on the input|26 Jan 1788}}
{{{{BASEPAGENAME}}/testcases/row|March 12, 1557}}
{{{{BASEPAGENAME}}/testcases/row|1975-02-13}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a=<code>dmy</code>|b=displays the date in day-month-year format|Sep 13, 1888|format=dmy}}
{{{{BASEPAGENAME}}/testcases/row|1983-01-03|format=dmy}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a=<code>dm</code>|b=displays only the day and month in day-month format|Feb 26, 1788|format=dm}}
{{{{BASEPAGENAME}}/testcases/row|2020-10-15|format=dm}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a=<code>mdy</code>|b=displays the date in month-day-year format|August 31, 1901|format=mdy}}
{{{{BASEPAGENAME}}/testcases/row|2006-11-08|format=mdy}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a=<code>md</code>|b=displays only the day and month in month-day format|26 Jun 1988|format=md}}
{{{{BASEPAGENAME}}/testcases/row|2002-02-27|format=md}}
{{{{BASEPAGENAME}}/testcases/row|a=<code>my</code>|b=displays only the month and year in month-year format|16 November 1488|format=my}}
{{{{BASEPAGENAME}}/testcases/row|a=<code>d</code>|b=displays only the day|6 July 1666|format=d}}
{{{{BASEPAGENAME}}/testcases/row|a=<code>m</code>|b=displays only the month|1980-02-12|format=m}}
{{{{BASEPAGENAME}}/testcases/row|a=<code>y</code>|b=displays only the year|-26|Jan|18|format=y}}
{{{{BASEPAGENAME}}/testcases/row|a=<code>hide</code>|b=hides the date|15 October 1800|format=hide}}
|}

===Abbreviation===
There are two ways of abbreviating the month name.
# Directly input an abbreviated month name.
# Use the <code>abbr=on</code> parameter.

{|class="wikitable sortable"
|+ Examples
|-
!abbreviation method
!input code
!hidden sort key
!visible output
{{{{BASEPAGENAME}}/testcases/row|span=4|a=none|2000-01-01}}
{{{{BASEPAGENAME}}/testcases/row|2000|1|1}}
{{{{BASEPAGENAME}}/testcases/row|1 January 2000}}
{{{{BASEPAGENAME}}/testcases/row|2000|January|1}}
{{{{BASEPAGENAME}}/testcases/row|span=2|a=abbreviated input|1 Jan 2000}}
{{{{BASEPAGENAME}}/testcases/row|2000|Jan|1}}
{{{{BASEPAGENAME}}/testcases/row|span=4|a=<code>abbr{{=}}on</code>|1 January 2000|abbr=on}}
{{{{BASEPAGENAME}}/testcases/row|2000|January|1|abbr=on}}
{{{{BASEPAGENAME}}/testcases/row|2000-01-01|abbr=on}}
{{{{BASEPAGENAME}}/testcases/row|2000|1|1|abbr=on}}
|}

===Additional sort key===
In case two dates in a table are identical they may be ordered using the <code>addkey</code> parameter.

{|class="wikitable sortable"
|+ Examples
|-
!input code
!hidden sort key
!visible output
{{{{BASEPAGENAME}}/testcases/row|2010-10-10|addkey=3}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-09}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-10|addkey=1}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-10}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-10|addkey=4}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-11}}
{{{{BASEPAGENAME}}/testcases/row|2010-10-10|addkey=2}}
|}

===Wrapping===
To turn off the suppression of word wraps, use the <code>nowrap=off</code> parameter.

==TemplateData==
<templatedata>
{
"params": {
"1": {
"label": "Full date or year",
"description": "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.",
"example": "\"1893\", \"-89\", \"-10000\", \"Oct\", \"February 1767\", \"12 Aug 1987\", \"July 1, 1867\", \"25 October\", \"Jan 1\", \"2014-12-09\"",
"type": "string"
},
"2": {
"label": "Month",
"description": "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.",
"example": "February, Feb, 2 or 02",
"type": "string"
},
"3": {
"label": "Day",
"description": "Day, optionally zero-padded",
"example": "7 or 07",
"type": "number"
},
"4": {
"label": "Era",
"description": "BC, AD, BCE or CE. Takes effect only if the first parameter is a postive number.",
"type": "string"
},
"format": {
"label": "Format",
"description": "Controls the output format. Can be \"dmy\", \"dm\", \"mdy\", \"md\", \"my\", \"d\", \"m\", \"y\" or \"hide\".",
"type": "string"
},
"abbr": {
"label": "Abbreviation",
"description": "Abbreviates the month name",
"example": "on",
"type": "string",
"default": "off"
},
"addkey": {
"label": "Additional sort key",
"description": "Adds another sort key to resolve conflicts between rows with the same date",
"example": "3",
"type": "number"
},
"nowrap": {
"label": "Wrapping",
"description": "To turn off the suppression of word wraps, use the \"off\" parameter",
"example": "off",
"type": "string"
}
},
"description": "Date table sorting is used to correctly sort and display dates in a sortable table."
}
</templatedata>

==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 <code>link=off</code> used to suppress linking. In accordance with current guidelines linking of dates is no longer supported and instances of <code>link=off</code> should be removed.

==See also==
* {{tl|sort}}, sorting by a specified key (also good for complicated numbers, e.g. scientific notation)
* {{tl|sortname}}, full name sorting (using "last name, first name" as default sort key)
* {{tl|tts}}, for sorting times in result tables of athletic events (only needed in certain cases - see template documentation)
* {{tl|Number table sorting}}, for numbers

<includeonly>{{sandbox other||

[[Category:Sorting templates|{{BASEPAGENAME}}]]
[[Category:Date mathematics templates]]
}}</includeonly>

Template:Date table sorting/doc

2019-06-15T17:25:25Z

98.31.29.4:

{{Documentation subpage}}

{{High-use|26573}}
{{Mbox|type=content|text=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 {{Section link|Help:Sorting|Date sorting problems}}.}}
{{COinS safe|n}}
{{lua|Module:Dts}}

'''Dts''' (date time 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 August 2013 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===
{|class=wikitable
|-
|+The year, month and day can either be entered separately or as a single date.
|-
! style="width: 50%;" |{{tlf|dts|''year''|''month''|''day''|''BC''}}
! style="width: 50%;" |{{tlf|dts|''date''}}
|- style="vertical-align:top;"
|
* 1st parameter – Year (optional if month is given)
** Positive number (1 to 999,999,999,999) represent years AD or BC (dependant on the fourth parameter).
** Negative numbers (−1 to −999,999,999,999) represent years BC (without the fourth parameter).
** Year numbers must not contain commas or other formatting.
* 2nd parameter – Month (optional if the day is not given either)
** Full month name – e.g. February
** Abbreviated month name – e.g. Feb
** Month number – (either zero-padded or not) e.g. 2 or 02
* 3rd parameter – Day (optional)
** Day number – (either zero-padded or not) e.g. 7 or 07
* 4th parameter – (optional)
** May be BC, AD, BCE or CE
** Used with a positive year number
|
* 1st parameter – the full date
** By default YYYY-MM-DD format becomes month-day-year format and DD-MM-YYYY format becomes day-month-year while other formats remain in the order they are input.
** Abbreviated months are accepted and are abbreviated in the output.
** Capitalisation and comma mistakes are corrected.
** A single number is interpreted as a year, otherwise the date is parsed by the module. The following formats are accepted:
*** YYYY-MM-DD
*** DD-MM-YYYY
*** DD Month YYYY
*** Month DD, YYYY
*** YYYY-MM
*** DD Month
*** Month DD
*** Month YYYY
*** YYYY
*** Month
** Day and month numbers may be 1 or 2 digits, and year numbers may only be 3 or 4 digits. If you need to input a number less than 1000, use leading zeroes (e.g. "0700").
** BC years can only be parsed if the date is only the year number.
** If you need to include the day or month for BC years or years greater than 9999, you must use separate parameters for year, month and day.
|}

{| class="wikitable sortable"
|+ Examples
!input style
!input code
!hidden sort key
!visible output
{{dts/testcases/row|span=3|a={{tlf|dts|''year''}}|1893}}
{{dts/testcases/row|-89}}
{{dts/testcases/row|-10000}}
{{dts/testcases/row|a={{tlf|dts|''month''}}|Oct}}
{{dts/testcases/row|a={{tlf|dts|''month year''}}|February 1767}}
{{dts/testcases/row|a={{tlf|dts|''day month year''}}|12 Aug 1987}}
{{dts/testcases/row|a={{tlf|dts|''month day, year''}}|July 1, 1867}}
{{dts/testcases/row|a={{tlf|dts|''day month''}}|25 October}}
{{dts/testcases/row|a={{tlf|dts|''month day''}}|Jan 1}}
{{dts/testcases/row|a={{tlf|dts|''YYYY-MM-DD''}}|2014-12-09}}
{{dts/testcases/row|a={{tlf|dts|''DD-MM-YYYY''}}|15-05-2019}}
{{dts/testcases/row|span=3|a={{tlf|dts|''year''|''month''}}|1990|10}}
{{dts/testcases/row|1980|Dec}}
{{dts/testcases/row|1970|August}}
{{dts/testcases/row|span=2|a={{tlf|dts|''year''|''month''|''day''}}|2024|Jun|12}}
{{dts/testcases/row|-204|11|22}}
{{dts/testcases/row|span=2|a={{tlf|dts|''year''|''month''|''day''|''era''}}|44|3|15|BC}}
{{dts/testcases/row|94|Oct|17|AD}}
{{dts/testcases/row|a={{tlf|dts||''month''}}||May}}
{{dts/testcases/row|a={{tlf|dts||''month''|''day''}}||Sep|12}}
|}

===Formatting===
Using <code>format</code> produces a format that depends on, but is not necessarily equal to the format of the supplied date. The <code>format</code> parameter can take nine values.

{|class="wikitable sortable"
|+ Examples
|-
!value
!function
!input code
!hidden sort key
!visible output
{{dts/testcases/row|span=3|a= |b=format depends on the input|26 Jan 1788}}
{{dts/testcases/row|March 12, 1557}}
{{dts/testcases/row|1975-02-13}}
{{dts/testcases/row|span=2|a=<code>dmy</code>|b=displays the date in day-month-year format|Sep 13, 1888|format=dmy}}
{{dts/testcases/row|1983-01-03|format=dmy}}
{{dts/testcases/row|span=2|a=<code>dm</code>|b=displays only the day and month in day-month format|Feb 26, 1788|format=dm}}
{{dts/testcases/row|2020-10-15|format=dm}}
{{dts/testcases/row|span=2|a=<code>mdy</code>|b=displays the date in month-day-year format|August 31, 1901|format=mdy}}
{{dts/testcases/row|2006-11-08|format=mdy}}
{{dts/testcases/row|span=2|a=<code>md</code>|b=displays only the day and month in month-day format|26 Jun 1988|format=md}}
{{dts/testcases/row|2002-02-27|format=md}}
{{dts/testcases/row|a=<code>my</code>|b=displays only the month and year in month-year format|16 November 1488|format=my}}
{{dts/testcases/row|a=<code>d</code>|b=displays only the day|6 July 1666|format=d}}
{{dts/testcases/row|a=<code>m</code>|b=displays only the month|1980-02-12|format=m}}
{{dts/testcases/row|a=<code>y</code>|b=displays only the year|-26|Jan|18|format=y}}
{{dts/testcases/row|a=<code>hide</code>|b=hides the date|15 October 1800|format=hide}}
|}

===Abbreviation===
There are two ways of abbreviating the month name.
# Directly input an abbreviated month name.
# Use the <code>abbr=on</code> parameter.

{|class="wikitable sortable"
|+ Examples
|-
!abbreviation method
!input code
!hidden sort key
!visible output
{{dts/testcases/row|span=4|a=none|2000-01-01}}
{{dts/testcases/row|2000|1|1}}
{{dts/testcases/row|1 January 2000}}
{{dts/testcases/row|2000|January|1}}
{{dts/testcases/row|span=2|a=abbreviated input|1 Jan 2000}}
{{dts/testcases/row|2000|Jan|1}}
{{dts/testcases/row|span=4|a=<code>abbr{{=}}on</code>|1 January 2000|abbr=on}}
{{dts/testcases/row|2000|January|1|abbr=on}}
{{dts/testcases/row|2000-01-01|abbr=on}}
{{dts/testcases/row|2000|1|1|abbr=on}}
|}

===Additional sort key===
In case two dates in a table are identical they may be ordered using the <code>addkey</code> parameter.

{|class="wikitable sortable"
|+ Examples
|-
!input code
!hidden sort key
!visible output
{{dts/testcases/row|2010-10-10|addkey=3}}
{{dts/testcases/row|2010-10-09}}
{{dts/testcases/row|2010-10-10|addkey=1}}
{{dts/testcases/row|2010-10-10}}
{{dts/testcases/row|2010-10-10|addkey=4}}
{{dts/testcases/row|2010-10-11}}
{{dts/testcases/row|2010-10-10|addkey=2}}
|}

===Wrapping===
To turn off the suppression of word wraps, use the <code>nowrap=off</code> parameter.

==TemplateData==
<templatedata>
{
"params": {
"1": {
"label": "Full date or year",
"description": "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.",
"example": "\"1893\", \"-89\", \"-10000\", \"Oct\", \"February 1767\", \"12 Aug 1987\", \"July 1, 1867\", \"25 October\", \"Jan 1\", \"2014-12-09\"",
"type": "string"
},
"2": {
"label": "Month",
"description": "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.",
"example": "February, Feb, 2 or 02",
"type": "string"
},
"3": {
"label": "Day",
"description": "Day, optionally zero-padded",
"example": "7 or 07",
"type": "number"
},
"4": {
"label": "Era",
"description": "BC, AD, BCE or CE. Takes effect only if the first parameter is a postive number.",
"type": "string"
},
"format": {
"label": "Format",
"description": "Controls the output format. Can be \"dmy\", \"dm\", \"mdy\", \"md\", \"my\", \"d\", \"m\", \"y\" or \"hide\".",
"type": "string"
},
"abbr": {
"label": "Abbreviation",
"description": "Abbreviates the month name",
"example": "on",
"type": "string",
"default": "off"
},
"addkey": {
"label": "Additional sort key",
"description": "Adds another sort key to resolve conflicts between rows with the same date",
"example": "3",
"type": "number"
},
"nowrap": {
"label": "Wrapping",
"description": "To turn off the suppression of word wraps, use the \"off\" parameter",
"example": "off",
"type": "string"
}
},
"description": "Dts is used to correctly sort and display dates in a sortable table."
}
</templatedata>

==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===
Entering an invalid date format will (generally) produce an error message such as the one below.
<blockquote>{{dts|35 June 1900}}</blockquote>

Errors are tracked in [[:Category:Dts 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 <code>link=off</code> used to suppress linking. In accordance with current guidelines linking of dates is no longer supported and instances of <code>link=off</code> should be removed. Transclusions using the {{para|link}} parameter are tracked in [[:Category:Dts templates with deprecated parameters]].

==See also==
* {{tim|dts}}, since on Meta e.g. 09999 9999 induces numeric sort mode, "&" is prefixed to force string sort mode.
* {{tl|sort}}, sorting by a specified key (also good for complicated numbers, e.g. scientific notation)
* {{tl|sortname}}, full name sorting (using "last name, first name" as default sort key)
* {{tl|tts}}, for sorting times in result tables of athletic events (only needed in certain cases - see template documentation)
* {{tl|nts}}, for numbers

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

[[Category:Sorting templates|Dts]]
[[Category:Date mathematics templates]]

}}</includeonly>

Template:Date/doc

2018-12-07T01:36:18Z

98.31.29.4:

{{Documentation subpage}}

{{High-use| 40880 }}

===Description===
This template converts a date to one of the standard date formats used on the English Wikipedia.

'''This template should only be used internally in other templates.'''

If you want sortable dates for a table, use {{tl|Dts}} instead.

===Syntax===
This template takes up to two parameters, both of which are optional:

<code><nowiki>{{</nowiki>date|</code><span style="color:gray;">''<date to be formatted>''</span>|<span style="color:gray;">''<date formatting style>''</span><code><nowiki>}}</nowiki></code>
* '''''<date to be formatted>''''' is an (optional) date to be formatted.
*: If no date is specified, the template emits the current date.<br />For example, {{nowrap|<code><nowiki>{{date}}</nowiki></code>}} produces {{date}}. To avoid emitting the current date if none is input, use [[Template:fdate]].
*: If a date is provided, but is not recognized as one, the text is just returned ''as is''. Most dates will however be recognized as such, including all the formats typically used on Wikipedia. Numerous variations thereof are also supported, including abbreviated or lower-case month names; ordinal "st", "nd", "rd", "th"; extraneous white space; missing comma, etc.
*: '''Notes''':
*:* Some dates are converted even if they are not real dates, and some dates are not converted even though they are real dates. See [[#Known issues|known issues]] below.
*:* Only dates within the range {{date|January 1, 1000}} and {{date|December 31, 9999}} are supported. Dates with two-digit years will have the years from 1970 to 2069. Other dates outside the range 1000–9999 will be treated as if the second parameter were "none".
*:* when using month numbers in numeric, the valid formats are MM/DD/YYYY, DD-MM-YYYY, DD.MM.YYYY, YYYY/MM/DD, YYYY-MM-DD, MM/DD/YY, YY-MM-DD, DD.MM.YY, the invalid formats are DD/MM/YYYY, MM-DD-YYYY, MM.DD.YY, YYYY.MM.DD, MM.DD.YYYY, DD-MM-YY, YY/MM/DD, DD/MM/YY, YY.MM.DD
* '''''<date formatting style>''''' controls the date format in which the result is to be emitted. Recognized values for the second parameter are:
*:* '''<code style="padding-right:3em;">DMY</code>''' gives ''d mmmm yyyy'' (e.g. ''{{date|2007-05-31|DMY}}''). This is the default format.
*:* '''<code style="padding-right:3em;">MDY</code>''' gives ''mmmm d, yyyy'' (e.g. ''{{date|2007-05-31|MDY}}'')
*:* '''<code style="padding-right:3em;">YMD</code>''' gives ''yyyy mmmm d'' (e.g. ''{{date|2007-05-31|YMD}}'')
*:* '''<code style="padding-right:3em;">ISO</code>''' gives an [[WP:ISO 8601|ISO 8601]] style ''yyyy-mm-dd'' (e.g. ''{{date|2007-05-31|ISO}}'')
*:* '''<code style="padding-right:2.5em;">none</code>''' applies no formatting whatsoever
*: If a date to be formatted is provided but no style is specified, the template emits a date in "d month yyyy" format, as it appears (for example) on discussion pages. When no date is specified, then the current date is emitted with no year, either in "d month" format for formatting style <code>DMY</code>, or in "month d" format for formatting styles <code>MDY</code>, <code>YMD</code> and <code>ISO</code>.
*: '''Notes''':
*:* Although these are the four formats supported by MediaWiki's date autoformatting mechanism, only <code>DMY</code>/<code>lDMY</code> and <code>MDY</code>/<code>lMDY</code> are in accordance with the English language Wikipedia's [[MOS:DATE#Full date formatting|Manual of Style]]. The use of <code>ISO</code>/<code>lISO</code> ([[WP:ISO 8601|ISO 8601]]) format ''within article prose'' is expressly discouraged by the Manual of Style; this format should only be used in tables, lists, or references.
*:* In each case, the result is exactly the same as what would be emitted by MediaWiki's date autoformatting mechanism.<div>However, dates are '''''not''''' manipulated by MediaWiki's date autoformatting mechanism even when linked. This permits dates to have a consistent appearance regardless of whether they are linked or not.</div>
*:* Wikipedia caches the current version of pages, and the template may display the date that the page was cached, rather than the current date.

===Examples===
====With valid input====
{| class="wikitable" style="width:80%; margin:0 10%; border: 2px solid gray"
! scope="col" style="width:20%;" | Format
! scope="col" style="width:40%;" | Input
! scope="col" style="width:40%;" | Output
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | not specified
| <code><nowiki>{{date|2006-08-04}}</nowiki></code>
| {{date|2006-08-04}}
|-
| <code><nowiki>{{date|Aug 4, 2006}}</nowiki></code>
| {{date|Aug 4, 2006}}
|-
| <code><nowiki>{{date|4 August 2006}}</nowiki></code>
| {{date|4 August 2006}}
|-
| <code><nowiki>{{date|4 August}}</nowiki></code>
| {{date|4 August}}
|-
| <code><nowiki>{{date|Aug 4}}</nowiki></code>
| {{date|Aug 4}}
|-
| <code><nowiki>{{date}}</nowiki></code>
| {{date}}
|-
| <code><nowiki>{{date|}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date|}} ''(missing year)''
|-
| <code><nowiki>{{date|2=}}</nowiki></code>
| {{date|2=}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, day-month-year (DMY)|DMY]]'' format
| <code><nowiki>{{date|2006-08-04|DMY}}</nowiki></code>
| {{date|2006-08-04|DMY}}
|-
| <code><nowiki>{{date|Aug 4, 2006|DMY}}</nowiki></code>
| {{date|Aug 4, 2006|DMY}}
|-
| <code><nowiki>{{date|4 August 2006|DMY}}</nowiki></code>
| {{date|4 August 2006|DMY}}
|-
| <code><nowiki>{{date|4 August|DMY}}</nowiki></code>
| {{date|4 August|DMY}}
|-
| <code><nowiki>{{date|Aug 4|DMY}}</nowiki></code>
| {{date|Aug 4|DMY}}
|-
| <code><nowiki>{{date||DMY}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||DMY}} ''(missing year)''
|-
| <code><nowiki>{{date|2=DMY}}</nowiki></code>
| {{date|2=DMY}}
|-
| <code><nowiki>{{date|{{date}}|DMY}}</nowiki></code>
| {{date|{{date}}|DMY}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, month-day-year (MDY)|MDY]]'' format
| <code><nowiki>{{date|2006-08-04|MDY}}</nowiki></code>
| {{date|2006-08-04|MDY}}
|-
| <code><nowiki>{{date|Aug 4, 2006|MDY}}</nowiki></code>
| {{date|Aug 4, 2006|MDY}}
|-
| <code><nowiki>{{date|4 August 2006|MDY}}</nowiki></code>
| {{date|4 August 2006|MDY}}
|-
| <code><nowiki>{{date|4 August|MDY}}</nowiki></code>
| {{date|4 August|MDY}}
|-
| <code><nowiki>{{date|Aug 4|MDY}}</nowiki></code>
| {{date|Aug 4|MDY}}
|-
| <code><nowiki>{{date||MDY}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||MDY}} ''(missing year)''
|-
| <code><nowiki>{{date|2=MDY}}</nowiki></code>
| {{date|2=MDY}}
|-
| <code><nowiki>{{date|{{date}}|MDY}}</nowiki></code>
| {{date|{{date}}|MDY}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, year-month-day (YMD)|YMD]]'' format
| <code><nowiki>{{date|2006-08-04|YMD}}</nowiki></code>
| {{date|2006-08-04|YMD}}
|-
| <code><nowiki>{{date|Aug 4, 2006|YMD}}</nowiki></code>
| {{date|Aug 4, 2006|YMD}}
|-
| <code><nowiki>{{date|4 August 2006|YMD}}</nowiki></code>
| {{date|4 August 2006|YMD}}
|-
| <code><nowiki>{{date|4 August|YMD}}</nowiki></code>
| {{date|4 August|YMD}}
|-
| <code><nowiki>{{date|Aug 4|YMD}}</nowiki></code>
| {{date|Aug 4|YMD}}
|-
| <code><nowiki>{{date||YMD}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||YMD}} ''(missing year)''
|-
| <code><nowiki>{{date|2=YMD}}</nowiki></code>
| {{date|2=YMD}}
|-
| <code><nowiki>{{date|{{date}}|YMD}}</nowiki></code>
| {{date|{{date}}|YMD}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[ISO 8601|ISO]]'' format
| <code><nowiki>{{date|2006-08-04|ISO}}</nowiki></code>
| {{date|2006-08-04|ISO}}
|-
| <code><nowiki>{{date|Aug 4, 2006|ISO}}</nowiki></code>
| {{date|Aug 4, 2006|ISO}}
|-
| <code><nowiki>{{date|4 August 2006|ISO}}</nowiki></code>
| {{date|4 August 2006|ISO}}
|-
| <code><nowiki>{{date|4 August|ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" |{{date|4 August|ISO}} ''(not in ISO format)''
|-
| <code><nowiki>{{date|Aug 4|ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" |{{date|Aug 4|ISO}} ''(not in ISO format)''
|-
| <code><nowiki>{{date||ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||ISO}} ''(missing year and not in ISO format)''
|-
| <code><nowiki>{{date|2=ISO}}</nowiki></code>
| {{date|2=ISO}}
|-
| <code><nowiki>{{date|{{date}}|ISO}}</nowiki></code>
| {{date|{{date}}|ISO}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''none'' format
| <code><nowiki>{{date|2006-08-04|none}}</nowiki></code>
| {{date|2006-08-04|none}}
|-
| <code><nowiki>{{date|Aug 4, 2006|none}}</nowiki></code>
| {{date|Aug 4, 2006|none}}
|-
| <code><nowiki>{{date|4 August 2006|none}}</nowiki></code>
| {{date|4 August 2006|none}}
|-
| <code><nowiki>{{date|4 August|none}}</nowiki></code>
| {{date|4 August|none}}
|-
| <code><nowiki>{{date|Aug 4|none}}</nowiki></code>
| {{date|Aug 4|none}}
|-
| <code><nowiki>{{date||none}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date || none}} ''(blank)''
|-
| <code><nowiki>{{date|2=none}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date|2=none}} ''(blank)''
|-
| <code><nowiki>{{date|{{date}}|none}}</nowiki></code>
| {{date|{{date}}|none}}
|}

====Other acceptable input====
A wide variety of other input formats are handled correctly by the template:

{| class="wikitable" style="width:80%; margin:0 10%"
! scope="col" style="width:50%;" | Input
! scope="col" style="width:50%;" | Output
|-
| <code><nowiki>{{date|1st December 2008}}</nowiki></code> ([[Ordinal number (linguistics)|ordinal]] 'st')
| {{date|1st December 2008}}
|-
| <code><nowiki>{{date|June 24 2006}}</nowiki></code> (missing comma)
| {{date|june 24 2006}}
|-
| <code><nowiki>{{date|24 june 2006}}</nowiki></code> (lowercase month name)
| {{date|24 june 2006}}
|-
| <code><nowiki>{{date|24 jun}}</nowiki></code> (abbreviated month name)
| {{date|24 jun}}
|-
| <code><nowiki>{{date|June 2006}}</nowiki></code>
| {{date|June 2006}}
|}

====Invalid input====
Input strings that the template cannot format are returned unaltered. This includes strings containing characters such as square brackets, so any links will result in unformatted output.

{| class="wikitable" style="width:80%; margin:0 10%"
! scope="col" style="width:50%;" | Input
! scope="col" style="width:50%;" | Output
|-
| <code><nowiki>{{date|23007-031-24}}</nowiki></code>
| {{date|23007-031-24}}
|-
| <code><nowiki>{{date|[[1 December]] [[2008]]|YMD}}</nowiki></code>
| {{date|[[1 December]] [[2008]] | YMD}}
|-
| <code><nowiki>{{date|1 December [[2008 in film|2008]]|MDY}}</nowiki></code>
| {{date|1 December [[2008 in film|2008]] | MDY}}
|-
| <code><nowiki>{{date|2008 December 1|DMY}}</nowiki></code>
| {{date|2008 December 1|DMY}} ''(expected: {{date|2008-12-01|DMY}})''
|-
| <code><nowiki>{{date|2008 December 1|MDY}}</nowiki></code>
| {{date|2008 December 1|MDY}} ''(expected: {{date|2008-12-01|MDY}})''
|-
| <code><nowiki>{{date|2008 December 1|ISO}}</nowiki></code>
| {{date|2008 December 1|ISO}} ''(expected: {{date|1 December 2008|ISO}})''
|}

===Known issues===
; Out-of-range values are "fixed"
* The [[PHP]] library, that this template ultimately depends on, converts out-of-range values to the next-best in-range values. As a result, some date-like values that are not actually valid dates get converted anyway. These include...
** all dates with zero day-of-the-month. Such a "zero-th" day of a month gets converted into the last day of the previous month.<div>For example, <code><nowiki>{{date|June 0, 2006}}</nowiki></code> results in <code>{{date|June 0, 2006}}</code>.</div><div>Similarly, <code><nowiki>{{date|0 January 2006}}</nowiki></code> becomes <code>{{date|0 January 2006}}</code>.</div>
** all dates with day-number values that exceed the number of days in the specified month cause the date to be incremented into the next month.<div>For example, <code><nowiki>{{date|31 November 2008}}</nowiki></code> results in <code>{{date|31 November 2008}}</code>, since November has only 30 days.</div><div>Similarly, <code><nowiki>{{date|February 29, 2007}}</nowiki></code> results in <code>{{date|February 29, 2007}}</code>, since 2007 was not a leap year.</div><div><small>Note: Due to a parser peculiarity in the PHP library, 'December 32' and '32 December' are treated differently, and the latter results in an error (which causes this template to emit it unchanged), and only the former "overflows" into the next month.</small></div>

; Non-Gregorian dates are treated as Gregorian
* The PHP library that this template ultimately depends on assumes that all dates, irrespective of context, are [[Gregorian calendar]] dates. Consequently:
** some dates that would be valid in a non-Gregorian context are treated as out-of-range dates and converted to the next-best in-range values. For example, <code><nowiki>{{date|30 February 1712}}</nowiki></code> results in <code>{{date|30 February 1712}}</code> because – even though 30 February 1712 is a valid date in the Swedish calendar – February 1712 had only 29 days in the Gregorian calendar.
** ten dates are not reformatted. These are 29 February & 1 March of the years 1000, 1100, 1300, 1400, 1500. The cause of this is the same as that of the Swedish 30 February 1712.
** some dates that would not be valid in some contexts are converted normally. For example, 29 February 1912 or 1 February 1918 are not valid in a Russian context, but perfectly valid in the Gregorian one.

; ISO 8601 format not suitable for years before 1583
The ISO 8601 standard requires mutual agreement between those using the format to use years earlier than 1583. Since no agreement has been obtained from our readers, that format should not be used for such years, nor for any date not in the Gregorian calendar.

; Output provided for ISO dates when year is missing
The current 2004 version of ISO 8601 does not permit omitting from the year, but this template will produce a supposedly ISO output when the year is missing.

; Does not provide Microformats
* [[hCalendar]] and [[hCard]] [[microformat]]s have various date properties, which are not emitted by this template. Use {{Tl|Start date}}, {{Tl|End date}}, {{Tl|Birth date}} or one of their variants, as necessary, in infoboxes which allow microformat-compatible date templates.

===See also===
{{Date and time templates}}

<includeonly>{{basepage subpage|

[[Category:Date conversion templates]]
[[Category:Date-computing templates]]
[[Category:ISO date templates]]
}}</includeonly>
<templatedata>
{
"params": {
"1": {
"label": "date",
"description": "Date to be formatted",
"example": "Jan 1, 2007",
"type": "date",
"suggested": true
},
"2": {
"label": "format",
"description": "controls the date format for the result",
"example": "MDY",
"type": "string",
"suggested": true
}
}
}
</templatedata>

Template:Date/doc

2018-07-24T20:02:29Z

98.31.29.4: use numbers

{{Documentation subpage}}

{{High-risk| 39,000+ }}

===Description===
This template converts a date to one of the standard date formats used on the English Wikipedia.

'''This template should only be used internally in other templates.'''

If you want sortable dates for a table, use {{tl|Dts}} instead.

===Syntax===
This template takes up to two parameters, both of which are optional:

<code><nowiki>{{</nowiki>date|</code><span style="color:gray;">''<date to be formatted>''</span>|<span style="color:gray;">''<date formatting style>''</span><code><nowiki>}}</nowiki></code>
* '''''<date to be formatted>''''' is an (optional) date to be formatted.
*: If no date is specified, the template emits the current date.<br />For example, {{nowrap|<code><nowiki>{{date}}</nowiki></code>}} produces {{date}}. To avoid emitting the current date if none is input, use [[Template:fdate]].
*: If a date is provided, but is not recognized as one, the text is just returned ''as is''. Most dates will however be recognized as such, including all the formats typically used on Wikipedia. Numerous variations thereof are also supported, including abbreviated or lower-case month names; ordinal "st", "nd", "rd", "th"; extraneous white space; missing comma, etc.
*: '''Notes''':
*:* Some dates are converted even if they are not real dates, and some dates are not converted even though they are real dates. See [[#Known issues|known issues]] below.
*:* Only dates within the range {{date|January 1, 1000}} and {{date|December 31, 9999}} are supported. Dates with two-digit years will have unexpected results. Other dates outside the range 1000–9999 will be treated as if the second parameter were "none".
* '''''<date formatting style>''''' controls the date format in which the result is to be emitted. Recognized values for the second parameter are:
*:* '''<code style="padding-right:3em;">DMY</code>''' gives ''d mmmm yyyy'' (e.g. ''{{date|2007-05-31|DMY}}''). This is the default format.
*:* '''<code style="padding-right:3em;">MDY</code>''' gives ''mmmm d, yyyy'' (e.g. ''{{date|2007-05-31|MDY}}'')
*:* '''<code style="padding-right:3em;">YMD</code>''' gives ''yyyy mmmm d'' (e.g. ''{{date|2007-05-31|YMD}}'')
*:* '''<code style="padding-right:3em;">ISO</code>''' gives an [[WP:ISO 8601|ISO 8601]] style ''yyyy-mm-dd'' (e.g. ''{{date|2007-05-31|ISO}}'')
*:* '''<code style="padding-right:2.5em;">none</code>''' applies no formatting whatsoever
*: If a date to be formatted is provided but no style is specified, the template emits a date in "d month yyyy" format, as it appears (for example) on discussion pages. When no date is specified, then the current date is emitted with no year, either in "d month" format for formatting style <code>DMY</code>, or in "month d" format for formatting styles <code>MDY</code>, <code>YMD</code> and <code>ISO</code>.
*: '''Notes''':
*:* Although these are the four formats supported by MediaWiki's date autoformatting mechanism, only <code>DMY</code>/<code>lDMY</code> and <code>MDY</code>/<code>lMDY</code> are in accordance with the English language Wikipedia's [[MOS:DATE#Full date formatting|Manual of Style]]. The use of <code>ISO</code>/<code>lISO</code> ([[WP:ISO 8601|ISO 8601]]) format ''within article prose'' is expressly discouraged by the Manual of Style; this format should only be used in tables, lists, or references.
*:* In each case, the result is exactly the same as what would be emitted by MediaWiki's date autoformatting mechanism.<div>However, dates are '''''not''''' manipulated by MediaWiki's date autoformatting mechanism even when linked. This permits dates to have a consistent appearance regardless of whether they are linked or not.</div>
*:* Wikipedia caches the current version of pages, and the template may display the date that the page was cached, rather than the current date.

===Examples===
====With valid input====
{| class="wikitable" style="width:80%; margin:0 10%; border: 2px solid gray"
! scope="col" style="width:20%;" | Format
! scope="col" style="width:40%;" | Input
! scope="col" style="width:40%;" | Output
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | not specified
| <code><nowiki>{{date|2006-08-04}}</nowiki></code>
| {{date|2006-08-04}}
|-
| <code><nowiki>{{date|08/04/2006}}</nowiki></code>
| {{date|08/04/2006}}
|-
| <code><nowiki>{{date|04-08-2006}}</nowiki></code>
| {{date|04-08-2006}}
|-
| <code><nowiki>{{date|4 Aug}}</nowiki></code>
| {{date|4 Aug}}
|-
| <code><nowiki>{{date|Aug 4}}</nowiki></code>
| {{date|Aug 4}}
|-
| <code><nowiki>{{date}}</nowiki></code>
| {{date}}
|-
| <code><nowiki>{{date|}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date|}} ''(missing year)''
|-
| <code><nowiki>{{date|2=}}</nowiki></code>
| {{date|2=}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, day-month-year (DMY)|DMY]]'' format
| <code><nowiki>{{date|2006-08-04|DMY}}</nowiki></code>
| {{date|2006-08-04|DMY}}
|-
| <code><nowiki>{{date|08/04/2006|DMY}}</nowiki></code>
| {{date|08/04/2006|DMY}}
|-
| <code><nowiki>{{date|04-08-2006|DMY}}</nowiki></code>
| {{date|04-08-2006|DMY}}
|-
| <code><nowiki>{{date|4 Aug|DMY}}</nowiki></code>
| {{date|4 Aug|DMY}}
|-
| <code><nowiki>{{date|Aug 4|DMY}}</nowiki></code>
| {{date|Aug 4|DMY}}
|-
| <code><nowiki>{{date||DMY}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||DMY}} ''(missing year)''
|-
| <code><nowiki>{{date|2=DMY}}</nowiki></code>
| {{date|2=DMY}}
|-
| <code><nowiki>{{date|{{date}}|DMY}}</nowiki></code>
| {{date|{{date}}|DMY}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, month-day-year (MDY)|MDY]]'' format
| <code><nowiki>{{date|2006-08-04|MDY}}</nowiki></code>
| {{date|2006-08-04|MDY}}
|-
| <code><nowiki>{{date|08/04/2006|MDY}}</nowiki></code>
| {{date|08/04/2006|MDY}}
|-
| <code><nowiki>{{date|04-08-2006|MDY}}</nowiki></code>
| {{date|04-08-2006|MDY}}
|-
| <code><nowiki>{{date|4 Aug|MDY}}</nowiki></code>
| {{date|4 Aug|MDY}}
|-
| <code><nowiki>{{date|Aug 4|MDY}}</nowiki></code>
| {{date|Aug 4|MDY}}
|-
| <code><nowiki>{{date||MDY}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||MDY}} ''(missing year)''
|-
| <code><nowiki>{{date|2=MDY}}</nowiki></code>
| {{date|2=MDY}}
|-
| <code><nowiki>{{date|{{date}}|MDY}}</nowiki></code>
| {{date|{{date}}|MDY}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[Calendar date#Gregorian, year-month-day (YMD)|YMD]]'' format
| <code><nowiki>{{date|2006-08-04|YMD}}</nowiki></code>
| {{date|2006-08-04|YMD}}
|-
| <code><nowiki>{{date|08/04/2006|YMD}}</nowiki></code>
| {{date|08/04/2006|YMD}}
|-
| <code><nowiki>{{date|04-08-2006|YMD}}</nowiki></code>
| {{date|04-08-2006|YMD}}
|-
| <code><nowiki>{{date|4 Aug|YMD}}</nowiki></code>
| {{date|4 Aug|YMD}}
|-
| <code><nowiki>{{date|Aug 4|YMD}}</nowiki></code>
| {{date|Aug 4|YMD}}
|-
| <code><nowiki>{{date||YMD}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||YMD}} ''(missing year)''
|-
| <code><nowiki>{{date|2=YMD}}</nowiki></code>
| {{date|2=YMD}}
|-
| <code><nowiki>{{date|{{date}}|YMD}}</nowiki></code>
| {{date|{{date}}|YMD}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''[[ISO 8601|ISO]]'' format
| <code><nowiki>{{date|2006-08-04|ISO}}</nowiki></code>
| {{date|2006-08-04|ISO}}
|-
| <code><nowiki>{{date|08/04/2006|ISO}}</nowiki></code>
| {{date|08/04/2006|ISO}}
|-
| <code><nowiki>{{date|04-08-2006|ISO}}</nowiki></code>
| {{date|04-08-2006|ISO}}
|-
| <code><nowiki>{{date|4 Aug|ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" |{{date|4 Aug|ISO}} ''(not in ISO format)''
|-
| <code><nowiki>{{date|Aug 4|ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" |{{date|Aug 4|ISO}} ''(not in ISO format)''
|-
| <code><nowiki>{{date||ISO}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date||ISO}} ''(not in ISO format and missing year)''
|-
| <code><nowiki>{{date|2=ISO}}</nowiki></code>
| {{date|2=ISO}}
|-
| <code><nowiki>{{date|{{date}}|ISO}}</nowiki></code>
| {{date|{{date}}|ISO}}
|- style="border-top: 2px solid gray"
! scope="row" rowspan="8" | ''none'' format
| <code><nowiki>{{date|2006-08-04|none}}</nowiki></code>
| {{date|2006-08-04|none}}
|-
| <code><nowiki>{{date|08/04/2006|none}}</nowiki></code>
| {{date|08/04/2006|none}}
|-
| <code><nowiki>{{date|04-08-2006|none}}</nowiki></code>
| {{date|04-08-2006|none}}
|-
| <code><nowiki>{{date|4 Aug|none}}</nowiki></code>
| {{date|4 Aug|none}}
|-
| <code><nowiki>{{date|Aug 4|none}}</nowiki></code>
| {{date|Aug 4|none}}
|-
| <code><nowiki>{{date||none}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date || none}} ''(blank)''
|-
| <code><nowiki>{{date|2=none}}</nowiki></code>
| style="background-color:#F0C0C0;" | {{date|2=none}} ''(blank)''
|-
| <code><nowiki>{{date|{{date}}|none}}</nowiki></code>
| {{date|{{date}}|none}}
|}

====Other acceptable input====
A wide variety of other input formats are handled correctly by the template:

{| class="wikitable" style="width:80%; margin:0 10%"
! scope="col" style="width:50%;" | Input
! scope="col" style="width:50%;" | Output
|-
| <code><nowiki>{{date|1st December 2008}}</nowiki></code> ([[Ordinal number (linguistics)|ordinal]] 'st')
| {{date|1st December 2008}}
|-
| <code><nowiki>{{date|June 24 2006}}</nowiki></code> (missing comma)
| {{date|june 24 2006}}
|-
| <code><nowiki>{{date|24 june 2006}}</nowiki></code> (lowercase month name)
| {{date|24 june 2006}}
|-
| <code><nowiki>{{date|24 jun}}</nowiki></code> (abbreviated month name)
| {{date|24 jun}}
|-
| <code><nowiki>{{date|June 2006}}</nowiki></code>
| {{date|June 2006}}
|}

====Invalid input====
Input strings that the template cannot format are returned unaltered. This includes strings containing characters such as square brackets, so any links will result in unformatted output.

{| class="wikitable" style="width:80%; margin:0 10%"
! scope="col" style="width:50%;" | Input
! scope="col" style="width:50%;" | Output
|-
| <code><nowiki>{{date|23007-031-24}}</nowiki></code>
| {{date|23007-031-24}}
|-
| <code><nowiki>{{date|[[1 December]] [[2008]]|YMD}}</nowiki></code>
| {{date|[[1 December]] [[2008]] | YMD}}
|-
| <code><nowiki>{{date|1 December [[2008 in film|2008]]|MDY}}</nowiki></code>
| {{date|1 December [[2008 in film|2008]] | MDY}}
|-
| <code><nowiki>{{date|2008 December 1|DMY}}</nowiki></code>
| {{date|2008 December 1|DMY}} ''(expected: {{date|2008-12-01|DMY}})''
|-
| <code><nowiki>{{date|2008 December 1|MDY}}</nowiki></code>
| {{date|2008 December 1|MDY}} ''(expected: {{date|2008-12-01|MDY}})''
|-
| <code><nowiki>{{date|2008 December 1|ISO}}</nowiki></code>
| {{date|2008 December 1|ISO}} ''(expected: {{date|1 December 2008|ISO}})''
|}

===Known issues===
; Out-of-range values are "fixed"
* The [[PHP]] library that this template ultimately depends on converts out-of-range values to the next-best in-range values. As a result, some date-like values that are not actually valid dates get converted anyway. These include...
** all dates with zero day-of-the-month. Such a "zero-th" day of a month gets converted into the last day of the previous month.<div>For example, <code><nowiki>{{date|June 0, 2006}}</nowiki></code> results in <code>{{date|June 0, 2006}}</code>.</div><div>Similarly, <code><nowiki>{{date|0 January 2006}}</nowiki></code> becomes <code>{{date|0 January 2006}}</code>.</div>
** all dates with day-number values that exceed the number of days in the specified month cause the date to be incremented into the next month.<div>For example, <code><nowiki>{{date|31 November 2008}}</nowiki></code> results in <code>{{date|31 November 2008}}</code>, since November has only 30 days.</div><div>Similarly, <code><nowiki>{{date|February 29, 2007}}</nowiki></code> results in <code>{{date|February 29, 2007}}</code>, since 2007 was not a leap year.</div><div><small>Note: Due to a parser peculiarity in the PHP library, 'December 32' and '32 December' are treated differently, and the latter results in an error (which causes this template to emit it unchanged), and only the former "overflows" into the next month.</small></div>

; Non-Gregorian dates are treated as Gregorian
* The PHP library that this template ultimately depends on assumes that all dates, irrespective of context, are [[Gregorian calendar]] dates. Consequently:
** some dates that would be valid in a non-Gregorian context are treated as out-of-range dates and converted to the next-best in-range values. For example, <code><nowiki>{{date|30 February 1712}}</nowiki></code> results in <code>{{date|30 February 1712}}</code> because – even though 30 February 1712 is a valid date in the Swedish calendar – February 1712 had only 29 days in the Gregorian calendar.
** ten dates are not reformatted. These are 29 February & 1 March of the years 1000, 1100, 1300, 1400, 1500. The cause of this is the same as that of the Swedish 30 February 1712.
** some dates that would not be valid in some contexts are converted normally. For example, 29 February 1912 or 1 February 1918 are not valid in a Russian context, but perfectly valid in the Gregorian one.

; ISO 8601 format not suitable for years before 1583
The ISO 8601 standard requires mutual agreement between those using the format to use years earlier than 1583. Since no agreement has been obtained from our readers, that format should not be used for such years, nor for any date not in the Gregorian calendar.

; Does not provide Microformats
* [[hCalendar]] and [[hCard]] [[microformat]]s have various date properties, which are not emitted by this template. Use {{Tl|Start date}}, {{Tl|End date}}, {{Tl|Birth date}} or one of their variants, as necessary, in infoboxes which allow microformat-compatible date templates.

===See also===
{{Date and time templates}}

<includeonly>{{basepage subpage|

[[Category:Date conversion templates]]
[[Category:Date-computing templates]]
[[Category:ISO date templates]]
}}</includeonly>