View source for Template:Date missing/doc

{{documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{self ref|This template is an in-line request '''for the date that a source was published'''. For the '''date an event occurred''' use {{tl|when}}.}}
{{Nosubst}}
{{notice
 |text=It should only be placed in citation templates that are missing a date but should have one because the source cited is not properly identified without it. For example, most books and non-news Web pages are only published with a year as the publication date, and should ''not'' be tagged with this template. (See {{tl|year missing}} for missing publication years).
 |heading=Use this template sparingly
 |image=Ambox warning yellow.svg
}}
{{template shortcut|date?}}
{{tl|Date missing}} (or {{tl|date?}} for short) is an inline cleanup template flagging a broken source citation that is missing the date of publication of the cited source (or at least the specified fact that date is not available).  "Date" here usually means "more information than just the year".

Many references are added with an <code>access-date=</code> but no publication date. This may be due to the use of citation tools that cannot identify a page's date, but of course the <code>access-date=</code> is always today. The lack of a publication date is clearly wrong, an error; but {{tl|Citation}} documentation says clearly "Access dates are not required for links to published research papers, published books, or news articles with publication dates."

==Usage==
{{warnsign|Do not place this template in any {{cs1}} citation's {{para|date}} parameters. All text in {{para|date}} parameters is made part of the citation's [[WP:COinS|COinS]] metadata. The {{para|date}} parameters should include date data only.}}

For all free-form and {{cite xxx}}-type template references ({{tl|cite web}}, {{tl|cite book}}, {{tl|citation}}, etc.), place {{tlx|date missing<!--|{{grey|<nowiki>{{subst:DATE}}</nowiki>}}-->}} at the end of the citation, typically just before the ending <code><nowiki></ref></nowiki></code> tag

==How to fix the problem flagged by this template==
'''Do not remove the template without fixing the problem one of the following ways.'''

*If you ''know the date'' (or date range in some cases), fill in the needed information, and remove the template. 
*;For a template-formatted citation, there are five basic ways to do this&#58;:
*#International format (for most articles), full format (usually for news items):
*#:{{para|date|<var>D[D]</var> <var>Monthname</var> <var>YYYY</var>}}
*#US format (for [[WP:ENGVAR|articles in American English]]), full format (usually for news items):
*#:{{para|date|<var>Monthname</var> <var>D[D]</var>, <var>YYYY</var>}}
*#Month and year only (usually for magazines and journals)
*#:{{para|date|<var>Monthname</var> <var>YYYY</var>}}
*#Or, if just a year would be more appropriate (e.g. for books and non-news websites), specify it using {{para|year}}:
*#:{{para|year|<var>YYYY</var>}}
*#:This solution is mainly for cases where {{tl|date missing}} was used improperly and {{tl|year missing}} really should have been used. Some templates such as {{tl|Cite journal}} and {{tl|Cite news}} really do expect a {{para|date}} not {{para|year}} parameter for most applications.
*#Some publications use some other kind of date range, such as a season or whatever:
*#:{{para|date|Winter 2009/2010}}
*#:{{para|date|March/April, 2010}}
*#:{{para|date|1st Quarter, 2010}}
*;For a free-form citation&#58;:
*#Just add the date, as appropriate to the format of the citation; or...
*#''Better yet'', convert the entire citation to {{tl|cite journal}}, {{tl|cite news}} or some other {{cite xxx}}-series template, as appropriate for the work in question.

*If you ''know that no date was specified'' by the original source, as is common on many non-news Web pages, you have several options, listed here in order of preference.
*#Use the copyright year (or year range) if one is specified, and use [square brackets] to specify that this is what it is:
*#:{{para|year|2006–2010 [copyright date]}}
*#:If the template will break without using the {{para|date}} parameter, then go ahead:
*#:{{para|date|2006–2010 [copyright date]}}
*#Failing that, for a ''non-news source'', use the page's last-modified date (use your browser's "get page info" type of command; for example it is "Tools > Page info" in Firefox on Windows); only use this date if it is plausible (many sites always show a very recent last-modified date because of dynamic content updating such as sidebar ads).
*#:{{para|date|23 March 2003 [last updated]}}
*#:Use the format appropriate for the article and source/citation type.
*#:This solution should never be used with news journalism, as it is closely tied an event's specific date, the accuracy of which is important for placing such a source in proper context.
*#Another option is an estimation, if you have reason to know approximately when something was published (i.e., you are better than guessing):
*#:{{para|date|ca. September 15, 2009}}
*#Finally, explicitly state that the year was unspecified if none of the above are practical (it will appear inside parentheses in most citation templates, but if it does not it should probably be put in [square brackets]):
*#:{{para|date|date unspecified}}
*#: or
*#:{{para|date|[date unspecified]}}
*:For free-form citations:
*:::<code>No date specified.</code>
*:Do ''not'' use question marks.
*:Do ''not'' just repeat the year if already given in a {{para|year}} parameter.
*:Do ''not'' leave the information blank and untag it, or someone else will just come along later and flag this with {{tl|date missing}} again!
*:Do ''not'' use {{para|date|none}}, {{para|date|unknown}} or anything else vague; any implication other than that ''the source itself'' did not specify a date is simply a signal to other editors to re-tag it with {{tl|date missing}}.

*If you ''don't know'':
*#Check the source and add the necessary information, as above.
*:Do ''not'' use question marks.
*:If the source is a dead link, check archive.org for a backup copy (see your {{tl|citation}}/{{cite xxx}}-type template's documentation for use of {{para|archiveurl}} and {{para|archivedate}} parameters). If no archive copy is available, use {{tl|dead link}} after the citation, but leave {{tl|date missing}} as well.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
    "description": "Use this inline template before a citation's </ref> tag to indicate that the citation is missing a full date where one is warranted. Not for use on events missing their date of occurrence; for this, use the template {{when}}.",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "Month and year of tagging; e.g., 'January 2013', but not 'jan13'",
			"type": "string",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"example": "January 2013",
			"suggested": true
		}
	}
}
</templatedata>

==See also==
{{Citation repair}}
;Other
* {{tl|when}} &ndash; to ask (in regular article prose) for the date that an event occurred

{{Inline tags}}
<includeonly>{{Sandbox other||
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Inline citation cleanup templates]]
[[Category:Time and date maintenance templates]]

}}</includeonly>