MarkAHershberger: 1 revision imported

2026-01-19T18:42:18Z

1 revision imported

← Older revision	Revision as of 18:42, 19 January 2026
(No difference)

w>Johnuniq: tweaks

2024-06-17T04:15:17Z

tweaks

New page

{{Documentation subpage}}
{{High-use}}
{{shortcut|Template:Age yd}}

{{Lua|Module:Age}}

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 [[Help:Sortable tables|sortable table]], use {{no redirect|Template:Ayd|<nowiki>{{ayd}}</nowiki>}} which redirects to {{tl|age in years and days nts}}.

Dates uses the [[Gregorian calendar]], without any Julian correction for [[Proleptic Gregorian calendar|proleptic Gregorian dates]] where the calendar was not effectively applied.

== Usage ==
Each date can be entered in a single parameter, or each date can be entered as three parameters: year, month, day.

* <code><nowiki>{{age in years and days|15 May 2010}}</nowiki></code> → {{age in years and days|15 May 2010}}
* <code><nowiki>{{age in years and days|12 Aug 2003|24 Sep 2011}}</nowiki></code> → {{age in years and days|12 Aug 2003|24 Sep 2011}}
* <code><nowiki>{{age in years and days|19 Jan 1689}}</nowiki></code> → {{age in years and days|19 Jan 1689}}
* <code><nowiki>{{age in years and days|4 October 1582|Oct 15, 1582}}</nowiki></code> → {{age in years and days|4 October 1582|Oct 15, 1582}}
* <code><nowiki>{{age in years and days|1989|7|23}}</nowiki></code> → {{age in years and days|1989|7|23}}
* <code><nowiki>{{age in years and days|1989|7|23|2003|7|24}}</nowiki></code> → {{age in years and days|1989|7|23|2003|7|24}}
* <code><nowiki>{{age in years and days|2007-03-02|2008-03-02}}</nowiki></code> → {{age in years and days|2007-03-02|2008-03-02}}
* <code><nowiki>{{age in years and days|1999-11-07|2112-02-15}}</nowiki></code> → {{age in years and days|1999-11-07|2112-02-15}}

An error is shown if an entered date is not valid (1800, 1900 and 2100 were not leap years).
* <code><nowiki>{{age in years and days|31 January 1892|29 February 1900}}</nowiki></code> → <span id="FormattingError"></span><strong class="error">Error: Second date should be year, month, day</strong>

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.
* <code><nowiki>{{age in years and days|13 April 753 BC|11 March 1986}}</nowiki></code> (proleptic) → {{age in years and days|13 April 753 BC|11 March 1986}} {{green|1=({{age in days|13 April 753 BC|11 March 1986|show unit=full}})}}
* <code><nowiki>{{age in years and days|-752|4|13|1986|3|11}}</nowiki></code> (proleptic) → {{age in years and days|-752|4|13|1986|3|11}}

== Options ==
The default is to separate years and days with a comma. The separator is "and" if {{para|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 {{para|duration|on}} is used.

* <code><nowiki>{{age in years and days|1 Jan 2011|31 Dec 2012}}</nowiki></code> → {{age in years and days|1 Jan 2011|31 Dec 2012}}
* <code><nowiki>{{age in years and days|1 Jan 2011|31 Dec 2012|sep=and}}</nowiki></code> → {{age in years and days|1 Jan 2011|31 Dec 2012|sep=and}}
* <code><nowiki>{{age in years and days|1 Jan 2011|31 Dec 2012|duration=on}}</nowiki></code> → {{age in years and days|1 Jan 2011|31 Dec 2012|duration=on}}

==TemplateData==
<templatedata>
{
"params": {
"1": {
"label": "Earlier date",
"description": "The earlier date being compared",
"type": "date",
"required": true
},
"2": {
"label": "Later date",
"description": "The later date being compared",
"type": "date",
"default": "Today's date",
"suggested": true
},
"sep": {
"label": "Separator",
"description": "Defines a custom separator between the years and days",
"type": "string",
"suggestedvalues": [
"and"
],
"default": ","
},
"duration": {
"label": "Duration?",
"description": "Set to \"on\" to include the second date in the calculation; will return a result one higher than if left off",
"type": "boolean"
}
},
"description": "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)",
"paramOrder": [
"1",
"2",
"sep",
"duration"
],
"format": "inline"
}
</templatedata>

{{Birth, death and age templates|age}}

<includeonly>{{Sandbox other||

[[Category:Date mathematics templates]]

}}</includeonly>

Template:Age in years and days/doc - Revision history

MarkAHershberger: 1 revision imported

w>Johnuniq: tweaks