Sjabloon:Death-date and age/doc
40px | This is a documentation subpage for Sjabloon:Death-date and age. It contains usage information, categories, interlanguage links and other content that is not part of the original sjabloon page. |
Returns a person's date of death and age at that date.
Besides calculating the age at death, the benefit of using this template, is to allow for the inclusion of hidden metadata to be used, indexed or searched by software tools.
Typical Usage
- Format
{{Death-date and age| death date | birth date}}
{{Death-date and age| death date | birth date | death date display form with links, templates etc. }}
Examples
Death-date and age examples (colors for emphasis only): |
Month first format: Sample below displays February 24, 1993, with invisible microformat dtend date: 1993-02-25 (aged 51)
|
Day first format: Sample below displays 24 February 1993, with invisible microformat dtend date: 1993-02-25 (aged 51)
|
Year only, year and month only: Sample below displays 1993, with invisible microformat dtend date: 1994 (aged 52)
|
Julian dates demo. Sample below displays 30 May 1672, with invisible microformat dtend date: 1692-06-10 (aged 49)
|
Extreme dates: Birth date is BC, death date AD Sample below displays August 19, AD 14, with invisible microformat dtend date: 0014-08-20 (aged 75)
|
Full list of Parameters
{{Death-date and age|
death date|birth date|additional parameters}}
Parameters
Parameter | Default | ||
---|---|---|---|
(required) | 1 | Death date. May be year only, year and month, year month and day, expressed in natural formats: eg: 24 August 1953, 1955-08-25, Sunday, December 7, 1941. If parameter three is not specified, the death date is displayed in exactly this format. This value as well as parameter 2 may not include links. If links or templates that do not evaluate as recognizable dates are desired, use parameter 3. | – |
(required) | 2 | Birth date. For accurate results, if year and month only was specified for death date, year and month should be specified for birth date (that is, the degree of precision should be in agreement). Julian dates may be used, but both Death and Birth dates must be on the same calendar. | – |
(optional) | 3 | The death date to display. This may include links or templates, or any combination of them, and overrides parameter 1. | parm 1 |
(optional) | bce | If birth date is BC, set to "b". If birth and death date are BC, set to "bd" or "d". | – |
(optional) | gregorian | If Julian dates are used, this parameter is required. The date provided is used for emitting the correct microformat translation of the death date. | parm 1 |
(optional) | dt | This value if present is the ISO8601 value emitted to indicate microformat death (dtend) date. It overrides any calculated value. | – |
Unusual dates
Julian dates
This template emits data in hidden microformat form. Technically, the requirement of this format is that all dates throughout time be expressed in the same calendar (the ISO8601 standard specifies this as gregorian), so julian calendar format dates cannot properly be used for this purpose. Proper emission of this invisible metadata requires that a gregorian calendar form be provided, even though properly speaking, gregorian dates did not exist prior to 1582. If accuracy of emission with microformats is a concern, the parameters death date and birth date that are displayed in the article may be provided in julian, and the correct gregorian death date form is provided in the "gregorian" parameter. Several calculators[1] that convert from Julian to Gregorian are available and are listed in the Julian calendar article. Example: Pope Adrian VI [2]:
- {{death-date and age| September 14, 1523 | March 2, 1459 | gregorian= September 24, 1523}}
There are some rare circumstances where system limitations do not permit correct handling of a few dates. These should have no impact on correct age calculation except in extremely unusual circumstances. When these errors create incorrect microformat data, use the dt parameter.
- some dates that would be valid in a non-Gregorian context are treated as out-of-range dates and converted to the next-best in-range values. For example,
{{date|30 February 1712}}
results in1 maart 1712
because – even though 30 February 1712 is a valid date in the Swedish calendar – February 1712 had only 29 days in the Gregorian calendar.- ten dates are not reformatted. These are 29 February & 1 March of the years 1000, 1100, 1300, 1400, 1500. The cause of this is the same as that of the Swedish 30 February 1712.
Dates with years less than 3 digits
Some dates with less than three digits will not be recognized. In these cases, use YYYY-MM-DD format for both death and birth dates. Use Parameter 3 to display the death date in the desired format. It is permitted to specify just Year or Year and month only.
Interaction side-effects with other templates
Note: Do not use this template inside of the Persondata template as it can interfere with data extraction.
See also
- Birth, death, age
- {{BirthDeathAge}} – combines functions of {{Birth-date}}, {{Birth date}}, {{Birth date and age}}, {{Birth year and age}}, {{Death-date}}, {{Death date}}, {{Death date and age}}, {{Death year and age}}
- {{Birth date}} – displays the date and related hidden metadata
- {{Birth date and age}} – same as {{Birth date}}, except that "(age ##)" appears after the birth date
- {{Birth date and age2}} – displays birth date, plus age as of a specified date, "(aged ##)" appears after the birth date
- {{Birth-date and age}} – display birth date and age, accepts dates as text (15 June 1950; June 15, 1950; June 1950; etc.)
- {{Birth year and age}} – year of birth and approximate age
- {{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
- {{Birth date based on age at death}} – displays approximate birth year based on age at death (useful if exact birth date is not known, but age at death is)
- {{Death date}} – displays the date and related hidden metadata
- {{Death date and age}} – same as {{Death date}}, except that "(aged ##)" appears after the death date
- {{Death-date and age}} – display death date and age, accepts date as text (15 June 1950; June 15, 1950; June 1950; etc.)
- {{Death date and given age}} – displays death date and specified age (useful if exact birth date is not known, but age at death is)
- {{Death year and age}} – year of death and approximate age at death
- Age only
- {{Age}} – age based on the number of full years between two dates (or a specified date and current date)
- {{Age nts}} – like {{Age}}, but sorts correctly in sortable tables
- {{Age as of date}} – current age in years, based on a known age as of a specified date
- {{Age in years and days}} – full years and days between two dates (or a specified date and current date)
- {{Age in years and days textual version}} – for usage in text (uses "and" instead of the comma)
- {{Age in days}} – age in days between two dates (or a specified date and current date)
- {{Age in days nts}} – age in days; sorts correctly in sortable tables