Дидани манбаъи Шаблон:Age2/doc

{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

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 {{tl|Age}} or {{tl|Age nts}} as well.

==Usage==
<pre>{{Age2|<year1(yyyy)>|<month1(mm)>|<day1(dd)>|<year2(yyyy)>|<month2(mm)>|<day2(dd)>|sortable=}}</pre>
* <code>year1</code>, <code>month1</code>, <code>day1</code> are for the starting date
* <code>year2</code>, <code>month2</code>, <code>day2</code> are for the ending date
* <code>year1</code> and <code>year2</code> are required
* <code>month1</code>, <code>month2</code>, <code>day1</code>, <code>day2</code> are optional, if one or some of them is unknown, it may be omitted, or left blank, or filled in "0", "00", like: <code><nowiki>{{Age2|2000|7|23|2010||}}</nowiki></code> or <code><nowiki>{{Age2|2000|7|23|2010}}</nowiki></code>; <code><nowiki>{{Age2|2000|0|0|2010|7|14}}</nowiki></code> or <code><nowiki>{{Age2|2000|||2010|7|14}}</nowiki></code>
* 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: <code><nowiki>{{Age2|-62|9|23|14|8|19}}</nowiki></code> returns "{{Age2|-62|9|23|14|8|19}}"
* "sortable", optional, fill in "yes" to add a hidden key, making it sort correctly in [[Help:Sorting|sortable tables]]: <code><nowiki>{{Age2|2000|7|23|2010|7||sortable=yes}}</nowiki></code> returns "{{Age2|2000|7|23|2010|7||sortable=yes}}", whose HTML code is "<code><nowiki><span style="display:none">&10000000000000009500000</span>9-10</nowiki></code>", where it is considered 9.5, making it greater than 9 but less than 10.

===Examples===
{| class="wikitable sortable" style="float:right;"
|+ Sortable Example
|-
! Click<br />to<br />sort
! class="unsortable" |Starting<br />date
! class="unsortable"| Ending<br />date
|-
| {{Age2|2000|7|23|2010|7|14|sortable=yes}} || {{date|2000-7-23}} || {{date|2010-7-14}}
|-
| {{Age2|2000|7|23|2010|7|29|sortable=yes}} || {{date|2000-7-23}} || {{date|2010-7-29}}
|-
| {{Age2|2000|7|23|2010|7||sortable=yes}} || {{date|2000-7-23}} || {{date|2010-7}}
|}
* <code><nowiki>{{Age2|2000|7|23|2010|7|14}}</nowiki></code> returns "{{Age2|2000|7|23|2010|7|14}}"
* <code><nowiki>{{Age2|2000|7|23|2010|7|}}</nowiki></code> returns "{{Age2|2000|7|23|2010|7|}}" (if day2 >= 23 it'll be 10, otherwise it'll be 9)
* <code><nowiki>{{Age2|2000|6|23|2010|7|}}</nowiki></code> returns "{{Age2|2000|6|23|2010|7|}}" (it can only be 10)
* <code><nowiki>{{Age2|2000|8|23|2010|7|}}</nowiki></code> returns "{{Age2|2000|8|23|2010|7|}}" (it can only be 9)
* <code><nowiki>{{Age2|2000|7||2010|7|}}</nowiki></code> returns "{{Age2|2000|7||2010|7|}}" (10 and 9 are both possible)

When one of the dates is the first or last day of the month or year:
* <code><nowiki>{{Age2|2000|1|1|2010||}}</nowiki></code> returns "{{Age2|2000|1|1|2010||}}" (it can only be 10, even if month2 and day2 are both 1)
* <code><nowiki>{{Age2|2000|7||2010|7|31}}</nowiki></code> returns "{{Age2|2000|7||2010|7|31}}" (it can only be 10, even if day1 = 31)
* <code><nowiki>{{Age2|2000|7|31|2010|7|}}</nowiki></code> returns "{{Age2|2000|7|31|2010|7|}}" (if day2 = 31 it'll be 10, otherwise it'll be 9)
* <code><nowiki>{{Age2|2000|2|29|2010|2|}}</nowiki></code> returns "{{Age2|2000|2|29|2010|2|}}" (it can only be 9)
* <code><nowiki>{{Age2|2000|2||2010|2|28}}</nowiki></code> returns "{{Age2|2000|2||2010|2|28}}" (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:
* <code><nowiki>{{age|1980|7|14|1993|6|233}}</nowiki></code> returns "{{age|1980|7|14|1993|6|233}}" (surplus days do not count as extra months)
* <code><nowiki>{{age|1980|7|14|1993|88|14}}</nowiki></code> returns "{{age|1980|7|14|1993|88|14}}" (surplus months do not count as extra years)
{{Esoteric}}

==See also==
* [[Wikipedia:Age calculation templates]]
; Age only
* {{tl|Age}} – age based on the number of full years between two dates (or a specified date and current date)
* {{tl|Age nts}} – similar to <nowiki>{{Age}}</nowiki>, but will sort correctly in sortable tables
* {{tl|Age in years and days}} – full years and days between two dates (or a specified date and current date)
* {{tl|Age in days}} – age in days between two dates (or a specified date and current date)
* {{tl|Age as of date}} – current age in years, based on a known age as of a specified date
; Birth, death, age
* {{tl|BirthDeathAge}} – displays birth/death dates and age
* {{tl|Birth date}} – displays the date and related hidden metadata
* {{tl|Birth date and age}} – same as {{tl|Birth date}}, except that "(age ##)" appears after the birth date
* {{tl|Birth date and age2}} – displays birth date, plus age as of a specified date, "(aged ##)" appears after the birth date
* {{tl|Birth year and age}} – year of birth and approximate age
* {{tl|Birth-date and age}} – display birth date and age, accepts dates as text (15 June 1950; June 15, 1950; June 1950; etc.)
* {{tl|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
* {{tl|Death date}} – displays the date and related hidden metadata
* {{tl|Death date and age}} – same as {{tl|Death date}}, except that "(aged ##)" appears after the death date
* {{tl|Death year and age}} – year of death and approximate age at death
* {{tl|Death-date and age}} – display death date and age, accepts date as text (15 June 1950; June 15, 1950; June 1950; etc.)
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Гурӯҳ:Date mathematics templates]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[bn:টেমপ্লেট:Age2]]
</includeonly>