Template:Age

Template documentation (for the above template, sometimes hidden or invisible)

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.

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

{{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}} → 14

{{age|1989|0|0|2003|7|14}} → 14

{{age|1989|7|23}} → 34

{{age|23 July 1989|14 July 2003}} → 13

{{age|July 1989|2003}} → 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 -2 etc. 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}} → 2238

{{age|August 2, 216 BCE}} → 2238

The options described at Module:Age can be used, for example:

{{age|format=commas|-215|8|2}} → 2,238

{{age|format=cardinal|1970|1|1|1998|2|1}} →

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

{{age|2010}} → <span class="currentage"></span>14

{{age|format=raw|2010}} → 14

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Age

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.

Template parameters[Edit template data]

Parameter		Description	Type	Status
Year ("from" date)	1	The year of the "from" date	Number	required
Month ("from" date)	2	The month of the "from" date, 1 through 12	Number	required
Day ("from" date)	3	The day (of month) of the "from" date, 1 through 31	Number	required
Year2 ("to" date)	4	The year of the "to" date, if required Default {{CURRENTYEAR}}	Number	optional
Month2 ("to" date)	5	The month of the "to" date, if required Default {{CURRENTMONTH}}	Number	optional
Day2 ("to" date)	6	The day (of month) of the "to" date, if required Default {{CURRENTDAY}}	Number	optional
Format	format	Date format Suggested values commas raw cardinal ordinal	String	optional

See also

• Template:Years ago – number of years in the past
• MOS:RELTIME – guideline on relative time references

Visit Template:Age/doc to edit this text! (How does this work?)