Template:Age nts/doc

From the AARoads Wiki: Read about the road before you go
Jump to navigation Jump to search

This acts just like {{Age}} but will sort correctly in sortable tables. It is used in more than 1,000.

The 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.

A hidden sort key is included so values produced by this template will work properly in sortable tables. The sort key is calculated from the number of days between the given dates, and is compatible with {{number table sorting}}.

Usage

{{Age nts|year|month|day|year2|month2|day2}} or
{{Age nts|year|month|day}}

Examples

For example, the following expression returns the number of full years elapsed between the fall of the Western Roman Empire on September 4, 476 AD, and the formation of the Italian Republic on June 2, 1946:
{{Age nts|476|9|4|1946|6|2}} returns "1,469"
{{Age nts|476|9|4}} returns "1,547"
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 nts|-215|8|2}} returns "2,238"
(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 nts|2000|4|22|2015|8|32}} returns "Error: Second date should be year, month, day" (surplus days do not count as extra months)
{{Age nts|2000|4|22|2015|13|7}} returns "Error: Second date should be year, month, day" (surplus months do not count as extra years)
{{Age nts|1900|2|29}} returns "Error: Need valid year, month, day" (1900 is not a leap year)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Age nts in articles based on its TemplateData.

TemplateData for Age nts

<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": "2024"
 },
 "5": {
   "label": "Month2 (\"to\" date)",
   "description": "The month of the \"to\" date, if required",
   "type": "number",
   "required": false,
   "default": "06"
 },
 "6": {
   "label": "Day2 (\"to\" date)",
   "description": "The day (of month) of the \"to\" date, if required",
   "type": "number",
   "required": false,
   "default": "26"
 }

</templatedata>

See also

  • {{nts}} - number table sorting