Template:Date/doc

This is a documentation subpage for Template:Date.

It contains usage information, categories, and other content that is not part of the original template page.

This template is imported from Template:Date/doc on Wikipedia.

This template is imported from the English Wikipedia. Although the visual appearance might be different, the functionality is identical. Please refer to the Template:Date/doc page on Wikipedia for detailed documentation.

{{Date}} converts a date to one of the standard date formats.

This template should only be used internally in other templates.

Examples

With valid input

Format	Input	Output
not specified	{{date|2006-08-04}}	4 August 2006
	{{date|Aug 4, 2006}}	4 August 2006
	{{date|4 August 2006}}	4 August 2006
	{{date|4 August}}	4 August
	{{date|Aug 4}}	4 August
	{{date|}}	22 December (missing year)
	{{date}}	22 December 2024
	{{date|2=}}	22 December 2024
DMY format	{{date|2006-08-04|DMY}}	4 August 2006
	{{date|Aug 4, 2006|DMY}}	4 August 2006
	{{date|4 August 2006|DMY}}	4 August 2006
	{{date|4 August|DMY}}	4 August
	{{date|Aug 4|DMY}}	4 August
	{{date||DMY}}	22 December (missing year)
	{{date|2=DMY}}	22 December 2024
	{{date|{{date}}|DMY}}	22 December 2024
MDY format	{{date|2006-08-04|MDY}}	August 4, 2006
	{{date|Aug 4, 2006|MDY}}	August 4, 2006
	{{date|4 August 2006|MDY}}	August 4, 2006
	{{date|4 August|MDY}}	August 4
	{{date|Aug 4|MDY}}	August 4
	{{date||MDY}}	December 22 (missing year)
	{{date|2=MDY}}	December 22, 2024
	{{date|{{date}}|MDY}}	December 22, 2024
YMD format	{{date|2006-08-04|YMD}}	2006 August 4
	{{date|Aug 4, 2006|YMD}}	2006 August 4
	{{date|4 August 2006|YMD}}	2006 August 4
	{{date|4 August|YMD}}	August 4
	{{date|Aug 4|YMD}}	August 4
	{{date||YMD}}	December 22 (missing year)
	{{date|2=YMD}}	2024 December 22
	{{date|{{date}}|YMD}}	2024 December 22
ISO format	{{date|2006-08-04|ISO}}	2006-08-04
	{{date|Aug 4, 2006|ISO}}	2006-08-04
	{{date|4 August 2006|ISO}}	2006-08-04
	{{date|4 August|ISO}}	--08-04
	{{date|Aug 4|ISO}}	--08-04
	{{date|{{#time: --m-d}}|ISO}}	--12-22 (missing year)
	{{date|2=ISO}}	2024-12-22
	{{date|{{date}}|ISO}}	2024-12-22
none format	{{date|2006-08-04|none}}	2006-08-04
	{{date|Aug 4, 2006|none}}	Aug 4, 2006
	{{date|4 August 2006|none}}	4 August 2006
	{{date|4 August|none}}	4 August
	{{date|Aug 4|none}}	Aug 4
	{{date||none}}	(blank)
	{{date|2=none}}	(blank)
	{{date|{{date}}|none}}	22 December 2024

Other acceptable input

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

Input	Output
{{date|1st December 2008}} (ordinal 'st')	1 December 2008
{{date|June 24 2006}} (missing comma)	24 June 2006
{{date|24 june 2006}} (lowercase month name)	24 June 2006
{{date|24 jun}} (abbreviated month name)	24 June
{{date|June 2006}}	June 2006
{{date|2006 June}}	1 June 2006
{{date|05/31/2012}}	31 May 2012
{{date|31-05-2012}}	31 May 2012

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.

Input	Output
{{date|23007-031-24}}	23007-031-24
{{date|[[1 December]] [[2008]]|YMD}}	1 December 2008
{{date|1 December [[2008 in film|2008]]|MDY}}	1 December 2008
{{date|2008 December 1|DMY}}	2008 December 1 (expected: 1 December 2008)
{{date|2008 December 1|MDY}}	2008 December 1 (expected: December 1, 2008)
{{date|2008 December 1|ISO}}	2008 December 1 (expected: 2008-12-01)
{{date|June 2006|ISO}}	June 2006 (missing day, expected: 2006-06--)
{{date|--08-24}}	--08-24
{{date|-08-24}}	23 December 2024
{{date|08-24}}	08-24
{{date|2006-08--}}	2006-08--
{{date|2006-08-}}	2006-08-
{{date|32 Aug}}	32 Aug
{{date|932 Aug}}	932 Aug
{{date|0932 Aug}}	0932 Aug
{{date|Aug 32}}	Aug 32
{{date|Aug 932}}	Aug 932
{{date|Aug 0932}}	Aug 0932
{{date|31/05/2012}}	31/05/2012 (expected 31 May 2012)
{{date|05-31-2012}}	05-31-2012 (expected 31 May 2012)
{{date|May 18, 2019|YDM}}	18 May 2019 (expected 2019 18 May)

TemplateData

Converts dates into a format used on Wikipedia

Template parameters

Parameter		Description	Type	Status
date	1	Date to be formatted Example Jan 1, 2007	Date	suggested
format	2	Controls the date format for the result Default DMY Example MDY	String	suggested