Template:Age in years and days/doc
 | This is a documentation subpage for Template:Age in years and days. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template is used on approximately 4,300 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: |
This template returns the number of full years and surplus days between two specified dates. If only one date is entered, the template returns the number of full years and surplus days between the specified date and today's date.
This template does not generate a sort key. In a sortable table, use {{ayd}} which redirects to {{age in years and days nts}}.
Dates uses the Gregorian calendar, without any Julian correction for proleptic Gregorian dates where the calendar was not effectively applied.
Usage
[edit]Each date can be entered in a single parameter, or each date can be entered as three parameters: year, month, day.
{{age in years and days|15 May 2010}}→ 14 years, 179 days{{age in years and days|12 Aug 2003|24 Sep 2011}}→ 8 years, 43 days{{age in years and days|19 Jan 1689}}→ 335 years, 296 days{{age in years and days|4 October 1582|Oct 15, 1582}}→ 11 days{{age in years and days|1989|7|23}}→ 35 years, 110 days{{age in years and days|1989|7|23|2003|7|24}}→ 14 years, 1 day{{age in years and days|2007-03-02|2008-03-02}}→ 1 year, 0 days{{age in years and days|1999-11-07|2112-02-15}}→ 112 years, 100 days
An error is shown if an entered date is not valid (1800, 1900 and 2100 were not leap years).
{{age in years and days|31 January 1892|29 February 1900}}→ Error: Second date should be year, month, day
Dates before the Common Era can use BC or BCE in a single parameter, or astronomical year numbering: 1 BCE is represented by 0, 2 BCE by −1, 3 BCE by −2 etc.
{{age in years and days|13 April 753 BC|11 March 1986}}(proleptic) → 2,737 years, 332 days (1,000,000 days){{age in years and days|-752|4|13|1986|3|11}}(proleptic) → 2,737 years, 332 days
Options
[edit]The default is to separate years and days with a comma. The separator is "and" if |sep=and is used.
The default calculates an age—the day of the second date is not included in the calculation. A duration including the second date is calculated if |duration=on is used.
{{age in years and days|1 Jan 2011|31 Dec 2012}}→ 1 year, 365 days{{age in years and days|1 Jan 2011|31 Dec 2012|sep=and}}→ 1 year and 365 days{{age in years and days|1 Jan 2011|31 Dec 2012|duration=on}}→ 2 years, 0 days
TemplateData
[edit]Returns the number of full years and surplus days between two specified dates (or, if only one date is entered, between the specified date and today's date)
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Earlier date | 1 | The earlier date being compared | Date | required |
| Later date | 2 | The later date being compared
| Date | suggested |
| Separator | sep | Defines a custom separator between the years and days
| String | optional |
| Duration? | duration | Set to "on" to include the second date in the calculation; will return a result one higher than if left off | Boolean | optional |