Template:Age2/doc

This is a documentation subpage for Template:Age2.
It may contain usage information, categories and other content that is not part of the original template page.

This template returns the number(s) of full years between two specified dates. It may return one number (e.g. "50") or two possible numbers (e.g. "50-51") of full years, depending on the given information of the two dates.

The template is especially designed for situations where the day, or day and month, of the two dates is unknown. If the year, month and day are all known, you may use {{Age}} or {{Age nts}} as well.

Usage

{{Age2|<year1(yyyy)>|<month1(mm)>|<day1(dd)>|<year2(yyyy)>|<month2(mm)>|<day2(dd)>|sortable=}}

year1, month1, day1 are for the starting date
year2, month2, day2 are for the ending date
year1 and year2 are required
month1, month2, day1, day2 are optional, if one or some of them is unknown, it may be omitted, or left blank, or filled in "0", "00", like: {{Age2|2000|7|23|2010||}} or {{Age2|2000|7|23|2010}}; {{Age2|2000|0|0|2010|7|14}} or {{Age2|2000|||2010|7|14}}
When entering dates before the Common Era, use astronomical year numbering: 1 BC is represented by 0, 2 BC by -1, 3 BC by -2, etc. For example, to calculate Augustus (23 September 63 BC – 19 August 14 AD)'s age: {{Age2|-62|9|23|14|8|19}} returns "75"
"sortable", optional, fill in "yes" to add a hidden key, making it sort correctly in sortable tables: {{Age2|2000|7|23|2010|7||sortable=yes}} returns "9-10", whose HTML code is "<span style="display:none">&10000000000000009500000</span>9-10", where it is considered 9.5, making it greater than 9 but less than 10.

Examples

Sortable Example
Click to sort	Starting date	Ending date
9	23 July 2000	14 July 2010
10	23 July 2000	29 July 2010
9-10	23 July 2000	1 July 2010

{{Age2|2000|7|23|2010|7|14}} returns "9"
{{Age2|2000|7|23|2010|7|}} returns "9-10" (if day2 >= 23 it'll be 10, otherwise it'll be 9)
{{Age2|2000|6|23|2010|7|}} returns "10" (it can only be 10)
{{Age2|2000|8|23|2010|7|}} returns "9" (it can only be 9)
{{Age2|2000|7||2010|7|}} returns "9-10" (10 and 9 are both possible)

When one of the dates is the first or last day of the month or year:

{{Age2|2000|1|1|2010||}} returns "10" (it can only be 10, even if month2 and day2 are both 1)
{{Age2|2000|7||2010|7|31}} returns "10" (it can only be 10, even if day1 = 31)
{{Age2|2000|7|31|2010|7|}} returns "9-10" (if day2 = 31 it'll be 10, otherwise it'll be 9)
{{Age2|2000|2|29|2010|2|}} returns "9" (it can only be 9)
{{Age2|2000|2||2010|2|28}} returns "9-10" (if day1 = 29 (2000 is a leap year) it'll be 9, otherwise it'll be 10)

Note

This template does not check for incorrect input:

{{age|1980|7|14|1993|6|233}} returns "Error: Second date should be year, month, day" (surplus days do not count as extra months)
{{age|1980|7|14|1993|88|14}} returns "Error: Second date should be year, month, day" (surplus months do not count as extra years)

This template employs intricate features of template syntax.

You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
You can conduct experiments, and should test all major changes, in either , the general template sandbox, or your user space before changing anything here.

{{Age}} – age based on the number of full years between two dates (or a specified date and current date)
{{Age nts}} – similar to {{Age}}, but will sort correctly in sortable tables
{{Age in years and days}} – full years and days between two dates (or a specified date and current date)
{{Age in days}} – age in days between two dates (or a specified date and current date)
{{Age as of date}} – current age in years, based on a known age as of a specified date

Birth, death, age

{{BirthDeathAge}} – displays birth/death dates and age
{{Birth date}} – displays the date and related hidden metadata
{{Birth date and age}} – same as {{Birth date}}, except that "(age ##)" appears after the birth date
{{Birth date and age2}} – displays birth date, plus age as of a specified date, "(aged ##)" appears after the birth date
{{Birth year and age}} – year of birth and approximate age
{{Birth-date and age}} – display birth date and age, accepts dates as text (15 June 1950; June 15, 1950; June 1950; etc.)
{{Birth based on age as of date}} – displays approximate birth year and current age; used when a dated reference mentions the age of a person as of the date of publication
{{Death date}} – displays the date and related hidden metadata
{{Death date and age}} – same as {{Death date}}, except that "(aged ##)" appears after the death date
{{Death year and age}} – year of death and approximate age at death
{{Death-date and age}} – display death date and age, accepts date as text (15 June 1950; June 15, 1950; June 1950; etc.)

Usage

Examples

Note

See also