View source for Template:Age/doc

{{Documentation subpage}}
{{High-risk|253,000+}}
{{Lua|Module:Age|Module:Date}}

== Usage ==

This template returns the number of full years between two specified dates. If the second set of parameters is not included, it returns the number of full years between a specified date and today's date.

Dates are checked for validity. For example, 29 February 2000 is accepted, but 29 February 1900 is not a valid date.

Partial dates such as July 1989 (no day) or 1989 (no month and no day) can be entered using <code>0</code> for missing values. Having no year, or having a day with no month is an error.

=== Policy ===
Please consult relevant Wikipedia policies and Manual of Style sections before using this template in article space.
* [[MOS:RELTIME]]


; Syntax:
: <code><nowiki>{{</nowiki>age|''year''|''month''|''day''|''year2''|''month2''|''day2''}}</code> {{green|or}}
: <code><nowiki>{{</nowiki>age|''year''|''month''|''day''}}</code> {{green|or}}
: <code><nowiki>{{</nowiki>age|''date''|''date2''}}</code> {{green|or}}
: <code><nowiki>{{</nowiki>age|''date''}}</code>

; Examples:
: <code><nowiki>{{</nowiki>age|1989|7|23|2003|7|14}}</code> → {{age|1989|7|23|2003|7|14}}
: <code><nowiki>{{</nowiki>age|1989|7|0|2003|7|14}}</code> → {{age|1989|7|0|2003|7|14}}
: <code><nowiki>{{</nowiki>age|1989|0|0|2003|7|14}}</code> → {{age|1989|0|0|2003|7|14}}
: <code><nowiki>{{</nowiki>age|1989|7|23}}</code> → {{age|1989|7|23}}
: <code><nowiki>{{</nowiki>age|23 July 1989|14 July 2003}}</code> → {{age|23 July 1989|14 July 2003}}
: <code><nowiki>{{</nowiki>age|July 1989|2003}}</code> → {{age|July 1989|2003}}

: When entering dates before the [[Common Era]], use astronomical year numbering: 1&nbsp;BCE is represented by <code>0</code>, 2&nbsp;BCE by <code>-1</code>, 3&nbsp;BCE by <code>-2</code> etc. For example, the following gives the number of full years since the battle of Cannae, which took place on August 2, 216 BCE:
:: <code><nowiki>{{</nowiki>age|-215|8|2}}</code> → {{age|-215|8|2}}
:: <code><nowiki>{{</nowiki>age|August 2, 216 BCE}}</code> → {{age|August 2, 216 BCE}}

The options described at [[Module:Age]] can be used, for example:
:: <code><nowiki>{{</nowiki>age|format=commas|-215|8|2}}</code> → {{age|format=commas|-215|8|2}}
:: <code><nowiki>{{</nowiki>age|format=cardinal|1970|1|1|1998|2|1}}</code> → {{age|format=cardinal|1970|1|1|1998|2|1}}
:: <code><nowiki>{{</nowiki>age|format=ordinal|1970|1|1|1998|2|1}}</code> → {{age|format=ordinal|1970|1|1|1998|2|1}}

When only one date is entered, the current date is used for the other date. The template outputs a span that can be used by a calling infobox to detect if only one date was used. The following shows two examples with the exact wikitext that is produced, as seen at [[Special:ExpandTemplates]]:
:: <code><nowiki>{{</nowiki>age|2010}}</code> → <code>&lt;span class="currentage">&lt;/span>{{age|format=raw|2010}}</code>
:: <code><nowiki>{{</nowiki>age|format=raw|2010}}</code> → <code>{{age|format=raw|2010}}</code>

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>{
"description": "This template returns the number of full years between two specified dates. If the second set of parameters is not included, it will return the number of full years between a specified date and today's date.",
"params": {
  "1": {
    "label": "Year (\"from\" date)",
    "description": "The year of the \"from\" date",
    "type": "number",
    "required": true
  },
  "2": {
    "label": "Month (\"from\" date)",
    "description": "The month of the \"from\" date, 1 through 12",
    "type": "number",
    "required": true
  },
  "3": {
    "label": "Day (\"from\" date)",
    "description": "The day (of month) of the \"from\" date, 1 through 31",
    "type": "number",
    "required": true
  },
  "4": {
    "label": "Year2 (\"to\" date)",
    "description": "The year of the \"to\" date, if required",
    "type": "number",
    "required": false,
    "default": "{{CURRENTYEAR}}"
  },
  "5": {
    "label": "Month2 (\"to\" date)",
    "description": "The month of the \"to\" date, if required",
    "type": "number",
    "required": false,
    "default": "{{CURRENTMONTH}}"
  },
  "6": {
    "label": "Day2 (\"to\" date)",
    "description": "The day (of month) of the \"to\" date, if required",
    "type": "number",
    "required": false,
    "default": "{{CURRENTDAY}}"
  }
}}
</templatedata>

== See also ==

* [[Template:Years ago]] {{ndash}} Number of years in the past

{{Birth, death and age templates|age}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Date mathematics templates]]
}}</includeonly>