编辑“︁Template:Age/doc”︁

<includeonly><!-- 在這裡加入模板的保護標識 -->{{high-use|88226}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- 
{{tiw|age}}.

This template returns the number of full years elapsed from one date until another date or until today (UTC). See [[{{TALKSPACE}}:{{PAGENAME}}]] 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>.
 -->
本模板返回两个指定日期之间相隔的完整年数，即计算满了多少年。如果第二个参数集未引入，则本模板返回一个指定日期与今天的日期之间相隔的满的年数。

== 使用方法 ==
;语法：
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year''|''month''|''day''|''year2''|''month2''|''day2''}}</code> 或 
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year''|''month''|''day''}}</code>

;举例：
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1989|7|23|2003|7|14}}</code>返回“{{{{BASEPAGENAME}}|1989|7|23|2003|7|14}}”
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1989|7|23}}</code>返回“{{{{BASEPAGENAME}}|1989|7|23}}”

:当使用此模板来计算某人死亡时的年龄，或者某人在一个指定日期时的年龄（而不是此人现在的年龄），请[[Help:替换引用|替代引用]]此模板到页面中。
:: 举例: <code><nowiki>{{subst:</nowiki>{{BASEPAGENAME}}|1989|7|23|2003|7|14}}</code>

: 为此模板输入[[公元前]]日期时，需使用[[天文計年]]表示法，以0表示公元前1年，-1表示公元前2年，-2表示公元前3年，依此类推。例如，下列用法为返回公元前216年8月2日至今已经过的整年数：
:: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|-215|8|2}}</code>返回“{{{{BASEPAGENAME}}|-215|8|2}}”

;注意：
:本模板不检查错误的输入：
:: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1980|7|14|1993|6|233}}</code>返回“{{{{BASEPAGENAME}}|1980|7|14|1993|6|233}}”（余下天数不计为额外月数。）
:: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1980|7|14|1993|88|14}}</code>返回“{{{{BASEPAGENAME}}|1980|7|14|1993|88|14}}”（余下月数不计为额外年数。）

== 注意 ==
*{{tl|Age in years and days}}調用此模板

== 参见 ==
*{{tl|age in days}}，以天为单位计算年龄。
*{{tl|Age in years and days}}，以年岁方式计算年龄。
*{{tl|birth date and age}}，用于显示某人出生日期与年龄。
*{{tl|death date and age}}，用于显示某人去世日期与年龄。
{{出生、逝世及日期模板|age}}

<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 -->
[[Category:日期計算模板]]
}}</includeonly>