View source for Template:Use dmy dates/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Template shortcut|dmy|DMY}}
{{high-risk| 1025385 }}
=== Usage ===
To promote consistent date formatting, place this template with other maintenance tags near the top of articles that use the <code>d&nbsp;mmmm&nbsp;yyyy</code> [[date format]] (below hatnotes, but above infoboxes, as  per the [[Wikipedia:Manual of Style/Lead section#Elements of the lead|Manual of Style]]). Use the parameter <code>|date=</code> for the month and year that an editor or [[WP:bot|bot]] last checked the article for inconsistent date formatting and fixed any found. 

Wikipedia articles that use <code>d&nbsp;mmmm&nbsp;yyyy</code> dates, either because of the [[MOS:DATERET|first main contributor]] rule or [[WP:TIES|close national ties]] (see [[Wikipedia:MOSNUM|MOSNUM]]), are systematically tagged with {{Tl|Use dmy dates}} over time. The template is invisible except in edit mode.

The template is useful to the editors to quickly know which date format is to be used when adding new dates into an article. It also facilitates article maintenance by enabling [[WP:bots|bots]] to recognise use of this format, and by adding the article to the [[WP:hidden category|hidden category]] [[:Category:Use dmy dates|Use dmy dates]].

'''Use of this template is part of a continuing effort to monitor the date formats used in articles, to assist in maintaining consistent formatting within an article. It is ''not'' a temporary "cleanup" template. Therefore, do not remove the template without valid reason, such as a determination the article uses or should use a different date format.'''

After being tagged, and bearing in mind article evolution, periodic script or bot runs clean up formats, correcting any new introductions since its last visit, and updating the visit date on the {{Tl|Use dmy dates}} template.

The dmy and mdy templates have almost always been used to indicate date styles in the body of the articles; although it ''may'' also indicate the flavour of dates in reference sections or parts thereof. Therefore, this template notice ought to be read in conjunction with the blurb at [[Wikipedia:Date formattings]]. [[User:Ohconfucius/script/MOSNUM dates|MOSNUM script documentation]] may also be relevant to those interested.

When a citation style does not expect differing date formats, it is permissible to normalize publication dates to the article body text date format, and/or access/archive dates to either, with date consistency being preferred (see [[MOS:DATEUNIFY]]).

===Auto-formatting citation template dates===

[[Help:Citation Style 1|Citation Style 1]] and [[Help:Citation Style 2|2]] (collectively cs1|2) templates automatically render dates ({{para|date}}, {{para|access-date}}, {{para|archive-date}}, etc) in the style specified by this template.  Because it is allowed by [[WP:MOSDATES]], the cs1|2 templates can automatically format dates in a variety of styles.  Editors may choose how cs1|2 templates render dates by the use of {{para|cs1-dates|&lt;{{var|keyword}}>}}.
{{#lst:Help:Citation Style 1|auto_date_format_table}}
An example is given at {{section link|Help:Citation Style 1#Auto-formatting citation template dates}}. <!-- An example cannot be given here because [[Module:Citation/CS1/Configuration]] gets the template's page name when this documentation page is transcluded.  That means that the module reads the template code but does not read the template documentation. --> 

{{lang|la|Nota bene}}: cs1|2 auto-date formatting does not apply when previewing an article section that does not contain a {{tld|use xxx dates}} template.  When editing with the visual editor, changes to this template do not take effect until the page is saved.

=== Syntax ===
{{Tlx|Use dmy dates|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|cs1-dates=}}

=== TemplateData ===
{{TemplateDataHeader}}
<templatedata>
{
	"description": "This template should be placed near the top of articles that use the d mmmm yyyy date format.",
	"params": {
		"date": {
			"label": "Date",
			"description": "The month and year that the article was last checked for inconsistent date formatting. Example: 'June 2013'; may use '{{subst:DATE}}' template instead",
			"type": "string",
			"required": false,
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"suggested": true
		}
	},
	"format": "{{_|_ = _}}\n"
}
</templatedata>

=== Wrongly tagged? ===
If, for example, you determine that an article has a template that is inappropriate for [[WP:TIES|its nationality]], you should substitute the appropriate template to avoid scripts or bots reapplying the "wrong" format in the course of maintenance.

=== See also ===
* {{Tl|Use mdy dates}}, for the <code>mmmm&nbsp;d,&nbsp;yyyy</code> format

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Templates with no visible output]]
[[Category:Time and date maintenance templates]]

}}</includeonly>