Template:Citation Style documentation/date: Difference between revisions

Template page
m (Reverted edits by 125.26.236.129 (talk) to last version by Mike Novikoff)
m (1 revision imported)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
* <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}} 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 the website and publisher. {{#if:{{{aliases|}}}|Aliases: {{{aliases}}}.}} {{crossref|For acceptable date formats, see {{section link|Help:Citation Style 1|Dates}}.}}
{{redirect|Wikipedia:Undated|undated signatures|Template:Undated}}
 
* <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}}
Line 6: Line 9:


{{Citation Style documentation/auto-date-format}}
{{Citation Style documentation/auto-date-format}}
* <b id="csdoc_year">year</b>: Year of source being referenced. The usage of this parameter is ''discouraged''; use the more flexible {{para|date}} parameter instead unless {{em|both}} of the following conditions are met:
* <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 {{para|date}} format is YYYY-MM-DD.
*# [[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.)
*# The citation requires a <code>[[Wikipedia:Citation templates and reference anchors|CITEREF]]</code> [[Template:Sfn#More than one work in a year|disambiguator]].{{#if:{{{limited_param_list|}}}||
*# 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|}}}||
* <!-- 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'''}}
* <!-- 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:
* <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:

Latest revision as of 23:22, 2 April 2024

  • 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.