Template:Age
Template documentation | This template is used on 31,000+ pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
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 0 for missing values. Having no year, or having a day with no month is an error.
- Syntax
{{age|year|month|day|year2|month2|day2}}or{{age|year|month|day}}or{{age|date|date2}}or{{age|date}}
- Examples
{{age|1989|7|23|2003|7|14}}→ 13{{age|1989|7|0|2003|7|14}}→ 13–14{{age|1989|0|0|2003|7|14}}→ 13–14{{age|1989|7|23}}→ 37{{age|23 July 1989|14 July 2003}}→ 13{{age|July 1989|2003}}→ 13–14
- When entering dates before the Common Era, use astronomical year numbering: 1 BCE is represented by
0, 2 BCE by-1, 3 BCE by-2etc. For example, the following gives the number of full years since the battle of Cannae, which took place on August 2, 216 BCE:{{age|-215|8|2}}→ 2241{{age|August 2, 216 BCE}}→ 2241
The options described at Module:Age can be used, for example:
{{age|format=commas|-215|8|2}}→ 2,241{{age|format=cardinal|1970|1|1|1998|2|1}}→ twenty-eight{{age|format=ordinal|1970|1|1|1998|2|1}}→ twenty-eighth
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:
{{age|2010}}→<span class="currentage"></span>15–16{{age|format=raw|2010}}→15–16
TemplateData
TemplateData for Age
<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": "2026"
},
"5": {
"label": "Month2 (\"to\" date)",
"description": "The month of the \"to\" date, if required",
"type": "number",
"required": false,
"default": "10"
},
"6": {
"label": "Day2 (\"to\" date)",
"description": "The day (of month) of the \"to\" date, if required",
"type": "number",
"required": false,
"default": "22"
}
}} </templatedata>
See also
- Template:Years ago – number of years in the past
- MOS:RELTIME – guideline on relative time references