Template:Citation Style documentation/date: Difference between revisions

From All Skies Encyclopaedia
imported>D'Ranged 1
m (Only one; should be singular, not plural)
imported>Rjjiii (ii)
m (→‎top: ce)
 
(38 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{redirect|Wikipedia:Undated|undated signatures|Template:Undated}}
* <span id="csdoc_date" />'''date''': Date of source being referenced. Can be full date (day, month, and year) or partial date (month and year, season and year, or year). Use same format as other publication dates in the citations.{{r|date|group=date}} Required when '''year''' is used to disambiguate {{tlx|sfn}} links to multiple-work citations by the same author in the same year.{{sup|[[Template:Sfn#More_than_one_work_in_a_year|[more]]]}} Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after publisher.{{#if:{{{aliases|}}}|&#32;Aliases: {{{aliases}}}}} {{crossref|For acceptable date formats, see {{section link|Help:Citation Style 1|Dates}}.}}

* <b id="csdoc_date">date</b>: Date of referenced source. Can be full date (day, month, and year) or partial date (month and year, season and year, or year). Use same format as other publication dates in the citations.{{r|date|group=date}} Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after the website and publisher. {{#if:{{{aliases|}}}|Aliases: {{{aliases}}}.}} {{crossref|For acceptable date formats, see {{section link|Help:Citation Style 1|Dates}}.}}
:[[Help:Shortened footnotes|Shortened footnotes]] target full citations using the year specified in this parameter. A lowercase letter may be suffixed to the year to disambiguate {{tlx|sfn}} links to multiple works by the same author in the same year,{{sup|[[Template:Sfn#More_than_one_work_in_a_year|[more]]]}} unless the date is formatted as YYYY-MM-DD. In the latter case, '''year''' or '''ref''' is required to disambiguate the link targets.
:For approximate year, precede with "<code>c. </code>", like this: {{para|date|c. 1900}}.
:For approximate year, precede with "<code>c. </code>", like this: {{para|date|c. 1900}}.
{{anchor|Undated}}
{{anchor|Undated}}
:For no date, or "undated", add as {{para|date|n.d.}}
:For no date, or "undated", use {{para|date|n.d.}}
:The date of a Web page, PDF, etc. with no visible date can sometimes be established by searching the page source or document code for a <code>created</code> or <code>updated</code> date; a comment for editors such as <code><nowiki>date=2021-12-25<!--date from page source-->|orig-date=Original date 2011-01-01</nowiki></code> can be added.
* <span id="csdoc_year" />'''year''': Year of source being referenced. Use of {{para|date}} is recommended unless all of the following conditions are met:

*# The template uses {{para|ref|harv}}, or the template is {{tlx|citation}}, or {{para|mode|cs2}}
{{Citation Style documentation/auto-date-format}}
*# The {{para|date}} format is YYYY-MM-DD.
* <b id="csdoc_year">year</b>: Year of publication. The more flexible {{para|date}} parameter also handles a year by itself. Do not use in combination with the <code class="tpl-para" style="word-break:break-word; ">|date=</code> parameter, unless <em >both</em> of the following conditions are met:
*# The citation requires a <code>[[Wikipedia:Citation templates and reference anchors|CITEREF]]</code> [[Template:Sfn#More than one work in a year|disambiguator]].
*# [[Help:Shortened footnotes|Shortened footnotes]] target multiple citations with same last name and year of publication. (This situation necessitates a <code>[[Wikipedia:Citation templates and reference anchors|CITEREF]]</code> [[Template:Sfn#More than one work in a year|disambiguator]], usually a lowercase letter suffixed to the year.)
* <span id="csdoc_origyear" />'''orig-year''': Original publication year; displays after the date or year. For clarity, please supply specifics. For example: {{para|orig-year|First published 1859}} or {{para|orig-year|Composed 1904}}. Alias: '''origyear'''
*# The <code class="tpl-para" style="word-break:break-word; ">|date=</code> format is YYYY-MM-DD. (This format prevents the addition of a disambiguating letter to the year.){{#if:{{{limited_param_list|}}}||
* <span id="csdoc_df" />'''df''': date format; sets rendered dates to the specified format; does not support date ranges or seasonal dates. Accepts one value which may be one of these:
* <!-- TBD: legacy csdoc_origyear anchor to be removed at a later stage -->{{anchor|csdoc_origyear}}<b id="csdoc_origdate">orig-date</b>: Original publication date or year; displays in square brackets after the '''date''' (or '''year'''). For clarity, please supply specifics. For example: {{para|orig-date|First published 1859}} or {{para|orig-date|Composed 1904}}. As {{para|orig-date}} does not support automatic date formatting, use the same date format as defined by {{para|df}} (or, if it exists in the article, by {{para|cs1-dates}} of a {{tlx|use dmy dates}} or {{tlx|use mdy dates}} template), or as used in the {{para|date}} parameter. Alias: '''orig-year'''}}
* <b id="csdoc_df">df</b>: date format; sets rendered dates to the specified format; does not support date ranges or seasonal dates; overrides the automatic date formatting described above. Accepts one value which may be one of these:
*:<code>dmy</code> – set publication dates to day month year format; access- and archive-dates are not modified;
*:<code>dmy</code> – set publication dates to day month year format; access- and archive-dates are not modified;
*:<code>mdy</code> – as above for month day, year format
*:<code>mdy</code> – as above for month day, year format
Line 15: Line 20:
*:<code>mdy-all</code> – as above for month day, year format
*:<code>mdy-all</code> – as above for month day, year format
*:<code>ymd-all</code> – as above for year initial numeric format YYYY-MM-DD
*:<code>ymd-all</code> – as above for year initial numeric format YYYY-MM-DD

{{#if:{{{aliases2|}}}|&#32;Aliases:{{{aliases2}}}}}
{{reflist|group=date|refs=<ref name=date>Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. {{crossref|See [[MOS:DATEUNIFY]].}}</ref>}}
{{reflist|group=date|refs=<ref name=date>Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. {{crossref|See [[MOS:DATEUNIFY]].}}</ref>}}

Latest revision as of 04:00, 7 November 2023

  • date: Date of referenced source. Can be full date (day, month, and year) or partial date (month and year, season and year, or year). Use same format as other publication dates in the citations.[date 1] Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after the website and publisher. For acceptable date formats, see Help:Citation Style 1 § Dates.
Shortened footnotes target full citations using the year specified in this parameter. A lowercase letter may be suffixed to the year to disambiguate {{sfn}} links to multiple works by the same author in the same year,[more] unless the date is formatted as YYYY-MM-DD. In the latter case, year or ref is required to disambiguate the link targets.
For approximate year, precede with "c. ", like this: |date=c. 1900.

For no date, or "undated", use |date=n.d.
The date of a Web page, PDF, etc. with no visible date can sometimes be established by searching the page source or document code for a created or updated date; a comment for editors such as date=2021-12-25<!--date from page source-->|orig-date=Original date 2011-01-01 can be added.
Automatic date formatting: Citation Style 1 and 2 templates, including this template, automatically render dates in all date parameters (such as |date=, |publication-date=, |access-date=, |archive-date=, etc.) except for |orig-date= in the style specified by the article's {{use dmy dates}} or {{use mdy dates}} template. See those templates' documentation for details.
  • year: Year of publication. The more flexible |date= parameter also handles a year by itself. Do not use in combination with the |date= parameter, unless both of the following conditions are met:
    1. Shortened footnotes target multiple citations with same last name and year of publication. (This situation necessitates a CITEREF disambiguator, usually a lowercase letter suffixed to the year.)
    2. The |date= format is YYYY-MM-DD. (This format prevents the addition of a disambiguating letter to the year.)
  • orig-date: Original publication date or year; displays in square brackets after the date (or year). For clarity, please supply specifics. For example: |orig-date=First published 1859 or |orig-date=Composed 1904. As |orig-date= does not support automatic date formatting, use the same date format as defined by |df= (or, if it exists in the article, by |cs1-dates= of a {{use dmy dates}} or {{use mdy dates}} template), or as used in the |date= parameter. Alias: orig-year
  • df: date format; sets rendered dates to the specified format; does not support date ranges or seasonal dates; overrides the automatic date formatting described above. Accepts one value which may be one of these:
    dmy – set publication dates to day month year format; access- and archive-dates are not modified;
    mdy – as above for month day, year format
    ymd – as above for year initial numeric format YYYY-MM-DD
    dmy-all – set publication, access-, and archive-dates to day month year format;
    mdy-all – as above for month day, year format
    ymd-all – as above for year initial numeric format YYYY-MM-DD
  1. Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. See MOS:DATEUNIFY.