Changes
this documentation is entirely technical. First stab at addressing the fact statements like "...17 years ago" are discouraged by MoS, even if this template makes it possible to avoid maintenance to update it.
{{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 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]] {{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>
{{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 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]] {{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>