Difference between revisions of "Template:Age/doc"
Jump to navigation
Jump to search
(←Blanked the page) |
blackwiki>Kendall-K1 m (Undid revision 708011396 by 76.168.162.154 (talk)) |
||
Line 1: | Line 1: | ||
+ | {{Documentation subpage}} | ||
+ | <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | ||
+ | {{High-risk|600,000+}} | ||
+ | == Usage == | ||
+ | |||
+ | 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. | ||
+ | |||
+ | ; Syntax<nowiki>:</nowiki> | ||
+ | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year''|''month''|''day''|''year2''|''month2''|''day2''}}</code> or | ||
+ | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year''|''month''|''day''}}</code> | ||
+ | |||
+ | ; Examples<nowiki>:</nowiki> | ||
+ | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1989|7|23|2003|7|14}}</code> returns "{{{{BASEPAGENAME}}|1989|7|23|2003|7|14}}" | ||
+ | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1989|7|23}}</code> returns "{{{{BASEPAGENAME}}|1989|7|23}}" | ||
+ | |||
+ | : When using this template to calculate a person's age at death or a person's age on a specified date (rather than the person's current age), please substitute it into the page (see [[Help:Substitution]]). | ||
+ | :: Example: <code><nowiki>{{subst:</nowiki>{{BASEPAGENAME}}|1989|7|23|2003|7|14}}</code> | ||
+ | |||
+ | : 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 expression returns the number of full years elapsed since the battle of Cannae, which took place on August 2, 216 BCE: | ||
+ | :: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|-215|8|2}}</code> returns "{{{{BASEPAGENAME}}|-215|8|2}}" | ||
+ | : (BCE is exactly the same as BC, so August 2, 216 BCE is also August 2, 216 BC) | ||
+ | |||
+ | ; Note<nowiki>:</nowiki> | ||
+ | : This template does not check for incorrect input: | ||
+ | :: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1980|7|14|1993|6|233}}</code> returns "{{{{BASEPAGENAME}}|1980|7|14|1993|6|233}}" (surplus days do not count as extra months) | ||
+ | :: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1980|7|14|1993|88|14}}</code> returns "{{{{BASEPAGENAME}}|1980|7|14|1993|88|14}}" (surplus months do not count as extra years) | ||
+ | |||
+ | ==TemplateData== | ||
+ | {{TemplateDataHeader}} | ||
+ | <templatedata>{ | ||
+ | "description": "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.", | ||
+ | "params": { | ||
+ | "1": { | ||
+ | "label": "Year (\"from\" date)", | ||
+ | "description": "The year of the \"from\" date", | ||
+ | "type": "number", | ||
+ | "required": true | ||
+ | }, | ||
+ | "2": { | ||
+ | "label": "Month (\"from\" date)", | ||
+ | "description": "The month of the \"from\" date, 1 through 12", | ||
+ | "type": "number", | ||
+ | "required": true | ||
+ | }, | ||
+ | "3": { | ||
+ | "label": "Day (\"from\" date)", | ||
+ | "description": "The day (of month) of the \"from\" date, 1 through 31", | ||
+ | "type": "number", | ||
+ | "required": true | ||
+ | }, | ||
+ | "4": { | ||
+ | "label": "Year2 (\"to\" date)", | ||
+ | "description": "The year of the \"to\" date, if required", | ||
+ | "type": "number", | ||
+ | "required": false, | ||
+ | "default": "{{CURRENTYEAR}}" | ||
+ | }, | ||
+ | "5": { | ||
+ | "label": "Month2 (\"to\" date)", | ||
+ | "description": "The month of the \"to\" date, if required", | ||
+ | "type": "number", | ||
+ | "required": false, | ||
+ | "default": "{{CURRENTMONTH}}" | ||
+ | }, | ||
+ | "6": { | ||
+ | "label": "Day2 (\"to\" date)", | ||
+ | "description": "The day (of month) of the \"to\" date, if required", | ||
+ | "type": "number", | ||
+ | "required": false, | ||
+ | "default": "{{CURRENTDAY}}" | ||
+ | } | ||
+ | }} | ||
+ | </templatedata> | ||
+ | |||
+ | ==See also== | ||
+ | {{Birth, death and age templates|age}} | ||
+ | |||
+ | <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | | ||
+ | <!-- Categories below this line, please; interwikis at Wikidata --> | ||
+ | [[Category:Date mathematics templates]] | ||
+ | }}</includeonly> |
Revision as of 02:33, 3 March 2016
![]() | This is a documentation subpage for Template:Age. It contains usage information, categories and other content that is not part of the original template page. |
![]() | This template is used on 31,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.
Transclusion count updated automatically (see documentation). |
Usage
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.
- Syntax:
{{Age|year|month|day|year2|month2|day2}}
or{{Age|year|month|day}}
- Examples:
{{Age|1989|7|23|2003|7|14}}
returns "13"{{Age|1989|7|23}}
returns "36"
- When using this template to calculate a person's age at death or a person's age on a specified date (rather than the person's current age), please substitute it into the page (see Help:Substitution).
- Example:
{{subst:Age|1989|7|23|2003|7|14}}
- Example:
- 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 expression returns the number of full years elapsed since the battle of Cannae, which took place on August 2, 216 BCE:
{{Age|-215|8|2}}
returns "2240"
- (BCE is exactly the same as BC, so August 2, 216 BCE is also August 2, 216 BC)
- 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)
TemplateData
This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.
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.
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
| Number | optional |
Month2 ("to" date) | 5 | The month of the "to" date, if required
| Number | optional |
Day2 ("to" date) | 6 | The day (of month) of the "to" date, if required
| Number | optional |
See also