Template:Age2/doc

From MattWiki
Jump to: navigation, search

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 "12" (surplus days do not count as extra months)
  • {{age|1980|7|14|1993|88|14}} returns "13" (surplus months do not count as extra years)

See also

Age only
  • {{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.)