Template:Age: Difference between revisions

Browse history interactively ← Previous editContent deleted Content addedVisual WikitextInline

Revision as of 17:32, 2 November 2006 view sourceKaldari (talk \| contribs)Autopatrolled, Extended confirmed users, File movers, Pending changes reviewers, Rollbackers68,434 edits adding usage note← Previous edit		Latest revision as of 06:09, 6 February 2021 view source Johnuniq (talk \| contribs)Autopatrolled, Administrators86,678 edits fix to not display confusing "0" on Template:Age per request
(30 intermediate revisions by 20 users not shown)
Line 1:		Line 1:
			<includeonly>{{#invoke:age\|age_generic\|template=age_full_years}}</includeonly><noinclude>{{documentation}}</noinclude>
	<includeonly>{{#expr:({{{4\|{{CURRENTYEAR}}}}})-({{{1}}})-(({{{5\|{{CURRENTMONTH}}}}})<({{{2}}})or({{{5\|{{CURRENTMONTH}}}}})=({{{2}}})and({{{6\|{{CURRENTDAY}}}}})<({{{3}}}))}}</includeonly><noinclude>

	{{tiw\|age}}.

	This template returns the number of full years elapsed from one date until another date or until today (UTC). See ] for examples.

	If you use this template for calculating someone's age at death or age at a certain date (rather than their current age), please substitute it into the page, for example: <nowiki>{{subst:age\|1989\|7\|23\|2003\|7\|14}}</nowiki>.


	]
	]
	</noinclude>

Latest revision as of 06:09, 6 February 2021

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

This template is used on approximately 39,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)
Module:Date (sandbox)

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, 1800 or 2100 are not valid dates.

{{age|1892|1|31|1900|2|29}} → Error: Second date should be year, month, day

{{age|1789|5|1|1800|2|29}} → Error: Second date should be year, month, day

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.

For the Supercentenarians, use {{age in years and days}} template.

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}} → 13–14; {{age|1989|0|0|2003|7|14}} → 13–14; {{age|1989|7|23}} → 35; {{age|23 July 1989|14 July 2003}} → 13; {{age|July 1989|2003}} → 13–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}} → 2239

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

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

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

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

{{age|format=ordinal|1970|1|1|1998|2|1}} → twenty-eighth

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–15

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

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 articles based on its 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
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

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 as of dates}}	To display approximate birth year and current age given several particular dates (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/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template. Category:

Date mathematics templates

Revision as of 17:32, 2 November 2006 view sourceKaldari (talk \| contribs)Autopatrolled, Extended confirmed users, File movers, Pending changes reviewers, Rollbackers68,434 edits adding usage note← Previous edit		Latest revision as of 06:09, 6 February 2021 view source Johnuniq (talk \| contribs)Autopatrolled, Administrators86,678 edits fix to not display confusing "0" on Template:Age per request
(30 intermediate revisions by 20 users not shown)
Line 1:		Line 1:
			<includeonly>{{#invoke:age\|age_generic\|template=age_full_years}}</includeonly><noinclude>{{documentation}}</noinclude>
	<includeonly>{{#expr:({{{4\|{{CURRENTYEAR}}}}})-({{{1}}})-(({{{5\|{{CURRENTMONTH}}}}})<({{{2}}})or({{{5\|{{CURRENTMONTH}}}}})=({{{2}}})and({{{6\|{{CURRENTDAY}}}}})<({{{3}}}))}}</includeonly><noinclude>

	{{tiw\|age}}.

	This template returns the number of full years elapsed from one date until another date or until today (UTC). See ] for examples.

	If you use this template for calculating someone's age at death or age at a certain date (rather than their current age), please substitute it into the page, for example: <nowiki>{{subst:age\|1989\|7\|23\|2003\|7\|14}}</nowiki>.


	]
	]
	</noinclude>

Misplaced Pages