Caleb Cooper: 1 revision imported

2020-10-25T18:27:15Z

1 revision imported

← Older revision	Revision as of 18:27, 25 October 2020
(No difference)

wikipedia>CapnZapp: see Template talk:Age#MOS:RELTIME

2020-04-24T17:24:18Z

see Template talk:Age

New page

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

Please remember to avoid phrasings such as "17 years ago" or "Jones is 65 years old", even when they use this template. See [[MOS:RELTIME]] for more information.

; 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 BCE is represented by <code>0</code>, 2 BCE by <code>-1</code>, 3 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><span class="currentage"></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]] – number of years in the past
* [[MOS:RELTIME]] – guideline on relative time references

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

<includeonly>{{Sandbox other||

[[Category:Date mathematics templates]]
}}</includeonly>

Template:Age/doc - Revision history

Caleb Cooper: 1 revision imported

wikipedia>CapnZapp: see Template talk:Age#MOS:RELTIME