Template documentation[view] [edit] [history] [purge]

This template is used on approximately 18,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:

Module:Age (sandbox)

This template returns the number of full years, then surplus months, then surplus days between two specified dates. If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date. The words "year", "month" and "day" are plural when appropriate.

The years and months are separated by a comma. Since serial commas are optional and use varies, this template does not automatically place a comma after the months. If a serial comma is desired, adding |sc=y to the template invocation will include one.

See Wikipedia:Age calculation templates for more information on using this kind of template.

Usage

((Age in years, months and days|year= |month= |day= )) or

((Age in years, months and days|yyyy|mm|dd|yyyy2|mm2|dd2))

Examples

((Age in years, months and days|year=2001|month=1|day=15)) returns "23 years and 27 days"

((Age in years, months and days|2001|01|15|2008|09|05)) returns "7 years, 7 months and 21 days"

((Age in years, months and days|2016|8|4|2016|9|5)) returns "1 month and 1 day"

Notes

This template can handle an ambiguous start date:

((Age in years, months and days|year=2010|month=9)) returns "13 years and 4 or 5 months"

((Age in years, months and days|2009|6||2011|2|21)) returns "1 year and 7 or 8 months"

But it cannot handle an ambiguous end date:

((Age in years, months and days|2012|11|2|2016|4)) returns "3 years and 4 or 5 months"

((Age in years, months and days|2012|11|2|2017)) returns "4 or 5 years"

Since the length of a month varies, the number of days to roll over the number of months varies.

((Age in years, months and days|2007|3|12|2015|6|11)) returns "8 years, 2 months and 30 days"

((Age in years, months and days|2007|3|12|2015|7|11)) returns "8 years, 3 months and 29 days"

To add a serial comma specify |sc=y.

((Age in years, months and days|year=2001|month=1|day=15|sc=y)) returns "23 years and 27 days"

((Age in years, months and days|2001|1|15|2008|9|5|sc=y)) returns "7 years, 7 months, and 21 days"

((Age in years, months and days|2006|8|26|sc=y)) returns "17 years, 5 months, and 16 days"

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Age in years, months and days in articles based on its TemplateData.

TemplateData for Age in years, months and days

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

Template parameters[Edit template data]
Parameter		Description	Type	Status
Year ('from' date)	`1` `year`	The year of the (first) date	Number	required
Month ('from' date)	`2` `month`	Number of the month of the (first) date	Number	required
Day of month ('from' date)	`3` `day`	The day of the month of the (first) date	Number	optional
Year ('to' date)	`4`	The year of the 'to' date, if required Default the current year	Number	optional
Month ('to' date)	`5`	Number of the month of the 'to' date, if required Default the current month	Number	optional
Day of month ('to' date)	`6`	The day of the month of the 'to' date, if required Default the current day	Number	optional
Serial comma	`sc`	Enter 'y' to turn on the serial comma after the months Default none	Line	optional

Birth templates	Description / use
((Birth date))	To display a birth date and related hidden metadata.
((Birth-date))
((Birth date and age))	((Birth date)) with suffix '(age N)'.
((Birth date and age2))	((Birth date and age)) plus age as of a specified date.
((Birth-date and age))	As ((Birth date and age)), but accepts dates in text form ('15 June 1950', 'June 15, 1950', 'June 1950', etc.).
((Birth date and age in years and days))	((Birth date and age)), but with the age displayed in years and days rather than just years.
((Birth year and age))	Year of birth and approximate age.
((Birth based on age as of date))	To display approximate birth year and current age given a particular date (e.g. when a dated reference mentions the age of a person), only works for living people.
((Birth based on age at death))	To display approximate birth year based on age at death, or on age at a specific date if death date isn't known.

Death templates	Description / use
((Death date))	To display a death date and related hidden metadata.
((Death-date))
((Death date and age))	((Death date)) with suffix '(aged N)'; also called with ((event date and age)).
((Death-date and age))	As ((Death date and age)), but accepts dates in text form ('15 June 1950', 'June 15, 1950', 'June 1950', etc.).
((Death date and given age))	To display a death date and specified age.
((Death year and age))	To display a year of, and approximate age at death.

age only

Conventional age templates	Description / use
((Age in years, months, weeks and days))	Number of complete years, months, weeks and days between two dates.
((Age in years, months and days))	Number of complete years, months and days between two dates.
((Age in years and months))	Number of complete years and remaining months between two dates.
((Age in years and days))	Number of complete years and remaining days between two dates.
((Age in years and days nts))	((Age in years and days)) with output formatted for use in number sortable tables.
((Age in decimal years))	Number of years between two dates, rounded to the specified number of decimal places.
((Age in years))	Number of years between two dates.
((Age in years nts))	((Age in years)) with output formatted for use in number sortable tables.
((Age in months))	Number of months between two dates.
((Age in weeks and days))	Number of weeks and days between two dates.
((Age in weeks))	Number of weeks between two dates.
((Age in days))	Age in days between two dates.
((Age in days nts))	((Age in days)) with output formatted for use in number sortable tables.

Reverse-determined age template	Description / use
((Age))	Age based on number of complete years between two dates.
((Age nts))	((Age)) with output formatted for use in number sortable tables.
((Age as of date))	Current age (in years) from a known age at a specified date.
((Age for infant))	Current age for infant: months and days up to one year, years and months up to three years, and years beyond age 3.

start / end dates

Date-focused templates	Description / use
((Start date)) / ((End date))
((Start-date)) / ((End-date))
((Start date and age))
((End date and age))

miscellaneous

Template	Description / use
((OldStyleDate))	Dates in Julian calendar.
((OldStyleDateDY))	As ((OldStyleDate)) but used when Julian / Gregorian dates fall in different years.
((OldStyleDateNY))	As ((OldStyleDate)) but without the year.
((Unidentified for))
((Missing for))

The above documentation is transcluded from Template:Age in years, months and days/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.

Usage

Examples

Notes

TemplateData

See also