Template:Date/doc

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Date.

---

This template is used to show a date in the language set in the preferences.

You can leave out parts of the data.

Usage

{{Date |year= |month= |day= |hour= |minute= |second= |lang= }}

Examples:

• {{date|2009|1|9}} → 9 January 2009
• {{date|2009|1|9|pl}} → 9 stycznia 2009
• {{date|2009|1|9|pl|form=}} → 9 stycznia 2009 - alternative way to get nominative case
• {{date|2009|1|9|pl|form=gen}} → 9 stycznia 2009
• {{date|2009|1|9|pl|form=ins}} → 9 stycznia 2009
• {{date|2009|1|pl}} → styczeń 2009
• {{date|2009|1|pl|form=gen}} → styczeń 2009
• {{date|2009|1|pl|form=ins}} → styczeń 2009
• {{date|year=888|lang=pl|form=ins|trim_year=yes}} →
• {{date|year=888|lang=pl|form=ins|trim_year=no}} →
• {{date|year=888|lang=pl|form=ins|trim_year=100-999}} →
• {{date|year=888|lang=pl|form=ins|trim_year=100-500}} →

Does not check existence, except for the month number:

• {{date|2009|12|33}} → December 2009
• {{date|2009|17|33}} → 2009

Microformat

The template returns the date, embed in a <time> element with attribute datetime that contain the date in the ISO 8601 format needed by the hCalendar (class="dtstart") microformat. See the microformats project.

Template parameters

Parameter	Description		Default	Status
year 1	year	Year number	empty	optional
month 2	month	Month number or name (in English)	empty	optional
day 3	day	Day number	empty	optional
hour	hour	Hour number in 0-23 range	empty	optional
minute	minute	Minutes number in 0-59 range	empty	optional
second	second	Seconds number in 0-59 range	empty	optional
lang 4	language	Language code (overrides user's preferences)	language code of the user language	optional
case	case	allows to specify grammatical case for the month for languages that use them. Possible cases: leave blank for nominative case "case=gen" for genitive case "case=loc" for locative case (supported for pl, cs & sl languages) "case=ins" for instrumental case (supported for ru, pl, cs & sl languages) Also Partitive (ptv), Inessive (ine), Elative (ela) and Illative (ill) cases are supported for Finnish language, in addition to Nominative and Genitive (gen).	empty	optional
class	class	allows to set the html class of the time node where the date is included. This is useful for microformats. The default value is, for legacy reasons, "dtstart" (used by hCalendar). See the microformats project. "class=" will remove all metadata.	dtstart	optional
trim_year	Should years smaller than 1000 be padded with zeros to the length of 4 digits or trimmed. Options: 1, yes, true - for always trimming 0, no, false - for always padding xx-yy - where xx is a minimum trimmed year and yy is the maximum trimmed year, for conditional trimming which depends on the year range.		100-999	optional

Additional information

The template is intended to be used in the following namespaces: the Template namespace

The template is intended to be used by the following user groups: all users

Relies on:
Module:Date

See also

{{ISOdate}} – Template used to parse the date in {{Information}}<br\> {{Other date}} - Allows to specify a range of non-trivial date notations in a format that is localizable

== Localization ==

Localize the date format at Module:I18n/date or request assistance at Template talk:Date or Module talk:I18n/date