Template:Age in years, months and days/doc
This template returns the number of full years, then surplus months, then surplus days between two specified dates or a sprefied date and today.
Usage
{{Age in years, months and days |year= |month= |day= |4= |5= |6= |sc= }}
If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date. The words "year", "month" and "day" are plural when appropriate.
The years and months are separated by a comma. Since serial commas are optional and use varies, this template does not automatically place a comma after the months. If a serial comma is desired, adding |sc=y
to the template invocation will include one.
See Wikipedia:Age calculation templates for more information on using this kind of template.
Template parameters
Parameter | Description | Default | Status | |
---|---|---|---|---|
year 1 | Year ('from' date) | The year of the (first) date | empty | required |
month 2 | Month ('from' date) | Number of the month of the (first) date | empty | required |
day 3 | Day of month ('from' date) | The day of the (first) date | empty | required |
4 | Year ('to' date) | The year of the 'to' date, if required | the current year | optional |
5 | Month ('to' date) | Number of the month of the 'to' date, if required | the current month | optional |
6 | Day ('to' date) | The day of the month of the 'to' date, if required | the current day | optional |
sc | Serial comma | Enter 'y' to turn on the serial comma after the months | empty | optional |
Additional information
The template is intended to be used in the following namespaces: no namespace specified
The template is intended to be used by the following user groups: no user group specified
See also
Examples
{{Age in years, months and days|year=2001|month=1|day=15}}
returns "23 years, 7 months and 5 days"{{Age in years, months and days|2001|01|15|2008|09|05}}
returns "7 years, 7 months and 21 days"{{Age in years, months and days|2016|8|4|2016|9|5}}
returns "1 month and 1 day"
Notes
This template can handle an ambiguous start date:
{{Age in years, months and days|year=2010|month=9}}
returns "13 years and 10 or 11 months"{{Age in years, months and days|2009|6||2011|2|21}}
returns "1 year and 7 or 8 months"
But it cannot handle an ambiguous end date:
{{Age in years, months and days|2012|11|2|2016|4}}
returns error{{Age in years, months and days|2012|11|2|2017}}
returns error
Since the length of a month varies, the number of days to roll over the number of months varies.
{{Age in years, months and days|2007|3|12|2015|6|11}}
returns "8 years, 2 months and 30 days"{{Age in years, months and days|2007|3|12|2015|7|11}}
returns "8 years, 3 months and 29 days"
To add a serial comma specify |sc=y
.
{{Age in years, months and days|year=2001|month=1|day=15|sc=y}}
returns "23 years, 7 months, and 5 days"{{Age in years, months and days|2001|1|15|2008|9|5|sc=y}}
returns "7 years, 7 months, and 21 days"{{Age in years, months and days|2016|08|6|sc=y}}
returns "8 years and 14 days"
TemplateData
- TemplateData
TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.
Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either useTemplateData=1
or useTemplateData=only
on the /doc
subpage and transcluding it with {{Documentation}} into the template. <nowiki>
-tags can be wrapped around the arguments, if required, to avoid templates being expanded.
Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw <templatedata>
-tags into the Wikitext of the template, as described in various Wikipediae.
Wikipedia's help about TemplateData • Commons-specific information
This template returns the number of full years, surplus months, and surplus days between two specified dates. If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Year ('from' date) | 1 year | The year of the (first) date | Number | required |
Month ('from' date) | 2 month | Number of the month of the (first) date | Number | required |
Day of month ('from' date) | 3 day | The day of the month of the (first) date | Number | optional |
Year ('to' date) | 4 | The year of the 'to' date, if required
| Number | optional |
Month ('to' date) | 5 | Number of the month of the 'to' date, if required
| Number | optional |
Day of month ('to' date) | 6 | The day of the month of the 'to' date, if required
| Number | optional |
Serial comma | sc | Enter 'y' to turn on the serial comma after the months
| Line | optional |