View source for Template:D/doc

<noinclude>{{doc subpage}}[[Category:Template documentation]]</noinclude>
== Documentation ==

This template formats dates according to users' [[Special:Preferences|preferences]] and links them to entries in our [[Timeline]]. If no date is specified, it uses the current date (which is almost certainly not what you want, since the link target would change each day). Dates that do not correspond to events in the timeline (including cases where the dates "just happen to" be in the timeline but refer to events not discussed there) can be formatted using {{tl|du}} instead of this template.

{{template name explanation|d|ate|the phrase=the word}}

{{high-usage-template warning}}

=== Usage ===

* {{tc-var|d|YYYY-MM-DD}}
* {{tc-var|d|YYYY-MM-DD|linktext}}
* {{tc-var|d|YYYY-MM-DD|add={{pnv|self|y}}}}
* {{tc-var|d|YYYY-MM-DD|linktext|add={{pnv|self|y}}}}

Setting the parameter {{tp|self}} (or its alias {{tp|here}}) to any [[Help:Truth|true value]], as seen in the third and fourth forms, will create a link to an anchor on the same page (a "self-link" or, more technically, "intrapage link"). This should be DONE when linking to related dates in the same year from an entry in one of the [[:Category:Years|year pages]] that make up our [[Timeline]]. For example, if the entry for {{du|2025-09-13}} [[2025#2025-09-13|in the 2025 article]] refers to the date {{du|2025-01-16}} (so, in that same year), then the date should be linked using {{tc|d|2025-01-16|self{{=}}y}} or {{tc|d|2025-01-16|here{{=}}y}}. Because if just {{tc|d|2025-01-16}} is used, then readers of the [[2025]] article will find themselves in the full Timeline after following that link, which is probably not what they wanted. (The functionality of this template might be changing in the future because of this very issue.)

=== Examples ===

* {{tc|d}} ⇒ {{d}}
* {{tc|d|2020-11-06}} ⇒ {{d|2020-11-06}}
* {{tc|d|2020-11-06|self{{=}}y}} ⇒ {{d|2020-11-06|self=y}}
* {{tc|d|2014-12-25|Christmas 2014}} ⇒ {{d|2014-12-25|Christmas 2014}}

"Hover" on the links to see the URLs being linked to.

Unless you have specified otherwise under [[Special:Preferences#mw-prefsection-rendering-dateformat|"Date format" in the "Appearances" tab of your own preferences]], you will see these examples rendered in the same "ISO date format" as the input shown in example template calls.

Here are all the formats that users can choose:

* 2020-11-06
* {{#formatdate:2020-11-06|mdy}}
* {{#formatdate:2020-11-06|dmy}}
* {{#formatdate:2020-11-06|ymd}}

== See also ==

* {{tl|da}} – formats a date and makes it an anchor for incoming links
* {{tl|du}} – formats a date but doesn't link it

<includeonly>
[[Category:Templates]]
[[Category:Templates for dates]]
[[Category:Templates for creating links]]
[[Category:Templates that can be called with or without input]]
</includeonly>