View source for Template:Lifespan/doc

{{Documentation subpage}}
<!--Includes elements of {{csdoc}} (Citation Style 1 documentation) adapted for this template.-->
{{ombox |type=notice |textstyle=text-align: center; color: green; font-weight: bold; font-style: italic; |text=This template accepts only <u>year values</u> in date-related parameters; see parameter {{xtn|[[#birth|birth]]}} for details, special cases, and exceptions.}}
{{lua |Module:Check for unknown parameters |nocat=true}}

This template may be used to display a person's or entity's whole lifespan in years, and optionally their final age or duration, also in years. It is intended for known, definite, singular lifespans, but may also handle limited cases of approximate or ambiguous date spans and corresponding age ranges. Presentation and notification options are available. All date-related information must be provided via sources acceptable by Wikipedia.

The implied default calendar is the [[Gregorian calendar]] and the editable implied default era is [[Anno Domini|AD]]|[[Common Era|CE]]; other possible use cases are described in {{slink||Applicability}}. Presentation is based on Wikipedia's [[WP:MOS|Manual of Style]], specifically [[MOS:YEAR]] and [[MOS:YEARRANGE]] (for date spans) and [[MOS:ERA]] (for the age component), with minor exceptions for programming simplicity and ease-of-use.

==Usage==

{{See also-text|{{slink||TemplateData}} for a usage summary}}
{{csdoc|usage full}}
<strong>Listed by relative importance</strong>{{br}}
<code><nowiki>{{lifespan |birth= |death= |or= |birth2= |death2= |suffix= |straddle= |circa= |prefix= |age-yrs= |age-range= |age-label= |label= |brackets= |msg= }}</nowiki></code>
{{br|2}}
<strong>Listed by display order</strong>{{br}}
<code><nowiki>{{lifespan |msg= |brackets= |label= |prefix= |circa= |birth= |or= |birth2= |straddle= |suffix= |death= |death2= |age-label= |age-range= |age-yrs= }}</nowiki></code>
{{end}}

===Syntax and interface elements{{efn|name=logic}}===

{{strong|Syntax:}} For basic use, only include the birth- and death-year, via required parameters {{para|birth}} and {{para|death}} (or in short-form {{para|b}} and {{para|d}}); year numbers must be entered fully, with {{nobr|all digits.{{efn|name=years}}}}{{br}}
All parameters are named; some parameters have predefined option sets. Most parameters and some parameter options have short-form aliases. All parameter and option names or aliases must be entered {{nobr|in lowercase.{{efn|name=temp}}}}{{br}}
Copy a blank version from the box above to use. Insert the "<code>{{!}}</code>" (pipe) character before parameters. Delete unused parameters. Unrecognized or undefined parameters are [[#???|normally ignored]]; defined parameters do not display without a value.{{br}}
{{strong|Date (year) elements:}} The template presumes [[Gregorian calendar]] information. It renders [[AD]] or [[Common Era|CE]] era spans as the implied default; [[AD|BC]] or [[Common Era|BCE]] lifespans, and most spans straddling eras, may also be rendered {{see below|{{slink||Era suffix}}}}. Year 0 (zero) is {{nobr|allowed,{{efn|name=zero}}}} but negative years are not; there is no special handling of [[Astronomical year numbering|astronomical dates]].&#8288;{{efn|name=astro}}{{br}}
{{strong|Age component:}} The optional [[#Age component|age component]] (the subject's age-at-death or duration, or the related age range) may be auto-calculated and displayed when feasible. The component is set to match the era configuration used by the {{nobr|date span.{{efn|name=ac}}}}{{br}}
{{strong|Presentation:}} Output is enclosed in brackets (parentheses) as the editable preset option; depending on the parameters used, other presentation and formatting elements including static text, white space and additional punctuation may be displayed.{{br}} 
{{strong|Errors and notices:}} Usage errors and requirement or constraint violations may suppress related template elements and produce unexpected, incomplete or incoherent output; the edited page may also be listed in a maintenance category {{see below|{{slink||Errors and notifications}}}}. Depending on the type of parameter(s) and the type of issue(s) involved, relevant notifications may display by default or by user preference. To reduce complexity, rare cases involving certain era-straddling date spans are unhandled exceptions {{see below|[[#!sdln|note]] below}}.

===Applicability<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->===

The template is primarily applicable to lifespans and eras that can be accurately represented by the Gregorian calendar. It is intended for a person's or entity's singular lifespan, which may include alternative, approximate or ambiguous birth- and/or death-years. It is not designed for, and may not be used to convey, a range of [[#as|probable]] discrete lifespans {{see below|also [[#!orn3|note]] under parameter {{italics correction|{{bxtn|[[#or|or]]}}}}}}.{{br}}
Other solar or [[lunar calendar|lunar]] calendars may be adaptable to the template{{snd}} in special cases, for historical period consistency, or when the template is included in articles that use additional or different calendars. However such use is not supported programmatically, and there are cases where the template may not be adaptable {{nobr|([[MOS:OSNS]]).{{efn|name=cals}}{{efn|name=astro}}}}

==Examples==

All examples in this section except "[[#allxc|All parameters]]" use short-form aliases of parameter and option names.

{{strong|No brackets|id=bktx}} &#91;[[#brackets|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=bkt=none}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |bkt=none}}

{{strong|Content label|id=lx}} &#91;[[#label|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=l=lc}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |l=lc}}

{{strong|Year prefixes|id=pfxx}} &#91;[[#prefix|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=pfx=tt}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |pfx=tt}}

{{strong|Era suffix|id=sfxx}} &#91;[[#suffix|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=sfx=ad}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |sfx=ad}}

{{strong|Era straddle|id=stradx}} &#91;[[#straddle|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=sfx=ad}}<nowiki> |</nowiki>{{bxt|1=sdl=y}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |sfx=ad |sdl=y}}

{{strong|Circa birth-year with prefixes|id=cax}} &#91;[[#circa|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=ca=b}}<nowiki> |</nowiki>{{bxt|1=pfx=tt}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |ca=b |pfx=tt}}

{{strong|Alternative birth-year with prefixes|id=b2x}} &#91;[[#birth2|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=or=b}}<nowiki> |</nowiki>{{bxt|1=b2={{#time: Y|-45 years}}}}<nowiki> |</nowiki>{{bxt|1=pfx=nt}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |b2={{#time: Y|-45 years}} |or=b |d={{#time: Y|-10 years}} |pfx=nt}}

{{strong|Alternative death-year with suffixes|id=d2x}} &#91;[[#death2|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=or=d}}<nowiki> |</nowiki>{{bxt|1=d2={{#time: Y|-5 years}}}}<nowiki> |</nowiki>{{bxt|1=sfx=ad}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d2={{#time: Y|-5 years}} |or=d |d={{#time: Y|-10 years}} |sfx=ad}}

{{strong|Ambiguous birth-year|id=~x}} &#91;[[#ambig|info]]&#93;
* <code><nowiki>{{lifespan |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=b=uncertain}}<nowiki>}}</nowiki></code>
:: {{lifespan |d={{#time: Y|-10 years}} |b=uncertain}}

{{strong|Unknown death-year with prefixes|id=?x}} &#91;[[#ambig|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |</nowiki>{{bxt|1=pfx=tt}}<nowiki> |</nowiki>{{bxt|1=d=unknown}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |pfx=tt |d=unknown}}

{{strong|Age component: Age range|id=arx1}} &#91;[[#age-range|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=ar=y}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |ar=y}}

{{strong|Age component: Age range with era straddle and age label option|id=arx2}} &#91;[[#age-range|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=ar=y}}<nowiki> |</nowiki>{{bxt|1=sfx=ad}}<nowiki> |</nowiki>{{bxt|1=sdl=y}}<nowiki> |</nowiki>{{bxt|1=al=dur}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |ar=y |sfx=ad |sdl=y |al=dur}}

{{strong|Age component: Age range with alternative years and prefixes|id=rxc}} &#91;[[#age-range|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-50 years}}<nowiki> |d=</nowiki>{{#time: Y|-10 years}}<nowiki> |</nowiki>{{bxt|1=ar=y}}<nowiki> |</nowiki>{{bxt|1=or=bd}}<nowiki> |</nowiki>{{bxt|1=b2={{#time: Y|-5 years}}}}<nowiki> |</nowiki>{{bxt|1=d2={{#time: Y|-5 years}}}}<nowiki> |</nowiki>{{bxt|1=pfx=nt}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-50 years}} |d={{#time: Y|-10 years}} |ar=y |or=bd |b2={{#time: Y|-5 years}} |d2={{#time: Y|-5 years}} |pfx=nt}}

{{strong|Age component: Age in years (death after birthday) with suffix|id=ayx1}} &#91;[[#age-yrs|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-10 years}}<nowiki> |d=</nowiki>{{#time: Y|-50 years}}<nowiki> |</nowiki>{{bxt|1=ay=abd}}<nowiki> |</nowiki>{{bxt|1=sfx=bc}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-10 years}} |d={{#time: Y|-50 years}} |ay=abd |sfx=bc}}

{{strong|Age component: Age in years (death before birthday) with suffix|id=ayx2}} &#91;[[#age-yrs|info]]&#93;
* <code><nowiki>{{lifespan |b=</nowiki>{{#time: Y|-10 years}}<nowiki> |d=</nowiki>{{#time: Y|-50 years}}<nowiki> |</nowiki>{{bxt|1=ay=bbd}}<nowiki> |</nowiki>{{bxt|1=sfx=bc}}<nowiki>}}</nowiki></code>
:: {{lifespan |b={{#time: Y|-10 years}} |d={{#time: Y|-50 years}} |ay=bbd |sfx=bc}}

{{strong|All parameters (select conditional parameters excluded programmatically)|id=allxc}}
* <code>{{bxt|<nowiki>{{lifespan |birth=</nowiki>{{#time: Y|-45 years}}<nowiki> |birth2=</nowiki>{{#time: Y|-50 years}}<nowiki> |death=</nowiki>{{#time: Y|-10 years}}<nowiki> |death2=</nowiki>{{#time: Y|-5 years}}<nowiki> |or=both |circa=both |suffix=ce |straddle=y |age-range=y |age-label=none |label=uc |brackets=age |msg=y}}</nowiki>}}</code>
:: {{lifespan |birth={{#time: Y|-45 years}} |death={{#time: Y|-10 years}} |suffix=ce |straddle=y |or=both |birth2={{#time: Y|-50 years}} |death2={{#time: Y|-5 years}} |circa=both |age-label=none |age-range=y |label=uc |brackets=age |msg=y}}

==Parameters<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->==
Listed alphabetically.

{{flatlist|
* {{bxtn|[[#age-label|age-label/al]]}}
* {{bxtn|[[#age-range|age-range/ar]]}}
* {{bxtn|[[#age-yrs|age-yrs/ay]]}}
* {{colored link|red|#birth|{{bxtn|birth/b}}}}
* {{colored link|purple|#birth2|{{bxtn|birth2/b2}}}}
* {{colored link|gray|#brackets|{{bxtn|brackets/bkt}}}}
* {{bxtn|[[#circa|circa/ca]]}}
* {{colored link|red|#death|{{bxtn|death/d}}}}
* {{colored link|purple|#death2|{{bxtn|death2/d2}}}}
* {{bxtn|[[#label|label/l]]}}
* {{bxtn|[[#msg|msg]]}}
* {{bxtn|[[#or|or]]}}
* {{bxtn|[[#prefix|prefix/pfx]]}}
* {{colored link|purple|#straddle|{{bxtn|straddle/sdl}}}}
* {{bxtn|[[#suffix|suffix/sfx]]}}
}}

{{small|Color legend: {{legend inline|red|size=80%}}Required {{legend inline|gray|size=80%}}Default (preset) {{legend inline|purple|size=80%}}Dependent/conditional {{legend inline|blue|size=80%}}Optional}}

===General notes===

With the exception of parameters and options that apply user preferences (e.g. regarding presentation or notifications), all user input {{vanchor|as|text={{em|must be provided via sources acceptable by Wikipedia}}}} ([[WP:V]]).{{br}}
The parameter set consists of 15 native parameters; they apply date information, age information, presentation options and notification options. Parameters may be required, dependent/conditional, default (preset), or optional.{{br}}
Dependent parameters and all parameter options are described under their prerequisites. Non-date parameters are normally ignored when misspelled, when any prerequisite is absent or when inserted without a value. Predefined option sets disallow any other input for the related parameter unless specifically stated otherwise.{{br}}
Incorrect parameter usage may suppress display of related template elements {{see below|{{slink||Description|Errors and notifications}}}}.

===Requirements and constraints===

* Parameters {{bxtn|[[#birth|birth]]}} (birth-year, alias {{bxtn|b}}) and {{bxtn|[[#death|death]]}} (death-year, alias {{bxtn|d}}) are required.
* Parameters {{bxtn|[[#birth2|birth2]]}} (alternative birth-year, alias {{bxtn|b2}}) and {{bxtn|[[#death2|death2]]}} (alternative death-year, alias {{bxtn|d2}}) depend on parameter {{bxtn|[[#or|or]]}} (birth and/or death is either of 2 years).
* Parameters {{bxtn|birth/b}} and {{bxtn|death/d}} must be the earliest birth-year and death-year respectively when parameter {{bxtn|or}} is used.
* The year value of parameter {{bxtn|birth/b}} must be earlier than any other date parameter's, but may equal the death-year (parameter {{bxtn|death/d}}).
* The year value of parameter {{bxtn|birth2/b2}} must be earlier than or equal the alternative death-year (parameter {{bxtn|death2/d2}}).
* The year value of parameter {{bxtn|death2/d2}} must be later than any other other date parameter's, but may equal the alternative birth-year (parameter {{bxtn|birth2/b2}}).
* When there is an alternative birth-year (parameter {{bxtn|birth2/b2}}) but no alternative death-year (parameter {{bxtn|death2/d2}}), the alternative birth-year must be earlier than or equal the death-year (parameter {{bxtn|death/d}}).
* Parameter {{bxtn|[[#straddle|straddle]]}} (date span straddles eras, alias {{bxtn|sdl}}) depends on parameter {{bxtn|[[#suffix|suffix]]}} (era suffix, alias {{bxtn|sfx}}).
* Parameter {{bxtn|[[#age-yrs|age-yrs]]}} (age in years, alias {{bxtn|ay}}) cannot be used with parameter {{bxtn|[[#age-range|age-range]]}} (range of ages in years, alias {{bxtn|ar}}) or with parameter {{bxtn|or}}.
* Parameter {{bxtn|[[#age-label|age-label]]}} (label for the age component, alias {{bxtn|al}}) requires parameter {{bxtn|age-yrs/ay}} or parameter {{bxtn|age-range/ar}}.
* Parameter {{bxtn|[[#label|label]]}} (content label, alias {{bxtn|l}}) cannot be used with parameter {{bxtn|[[#prefix|prefix]]}} (birth/death prefixes, alias {{bxtn|pfx}}).

Parameters and parameter options may have additional specific requirements, constraints and conditions.

===Description<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->===

====Date spans: Birth- and death-year, alternative birth- and death-year==== 

* {{vanchor|{{bxtn|birth}}}}, alias {{bxtn|b}}: {{para|birth[b]|{{var|yearnumber}}{{!}}uncertain{{!}}unknown}}
: Required. Enter {{em|only}} the subject's [[#as|birth, start, or origin year]] numerically in full decimal notation according to century or millennium. Negative years are not allowed. Year 0 (zero) may be used when {{nobr|applicable.{{efn|name=zero}}}} When this parameter is omitted, misspelled or has no value a notification is displayed and all other template output is suppressed.
: Must be chronologically earlier than any other date parameter, but may equal the death-year {{nobr|(parameter {{bxtn|death/d}}).{{efn|name=equal}}}}
: {{vanchor|ambig|text={{em|Options (conditional):}} When the birth-year is ambiguous or unknown,}} one of the options below may be used; they are incompatible with parameter {{bxtn|[[#circa|circa/ca]]}} when the latter is applied to this parameter. They are also incompatible with [[#Age component|the age component]]. These options may require additional supporting information ([[WP:V]])
: {{blist|{{para|birth|uncertain}}{{snd}} may be used when the birth-year is disputed, is one of three or more unique years proposed by acceptable sources, or is estimated within a period longer than [[wikt:circa|circa]] &#91;[[#~x|example]]&#93;
|{{para|birth|unknown}}{{snd}} may be used when the birth-year is unknown or undetermined &#91;[[#?x|example]]&#93;}}
: {{em|Note:}} Any other input for this parameter produces a notification {{see below|{{slink||Errors and notifications}} and table [[#et1|Error messages: Date parameters]]}}.

* {{vanchor|{{bxtn|death}}}}, alias {{bxtn|d}}: {{para|death[d]|{{var|yearnumber}}{{!}}uncertain{{!}}unknown}}
: Required. Enter {{em|only}} the subject's [[#as|death, end, or final year]] as described under parameter {{bxtn|birth/b}}; this parameter has identical requirements and [[#ambig|options]], but distinct numerical constraints:
: {{blist|Must be chronologically later than or equal the birth-year (parameter {{bxtn|birth/b}})
|Must be chronologically earlier than the alternative death-year (parameter {{bxtn|[[#death2|death2/d2]]}})
|When there is an alternative birth-year (parameter {{bxtn|[[#birth2|birth2/b2]]}}) but no alternative death-year (parameter {{bxtn|death2/d2}}) the death-year must be chronologically later than or equal the alternative birth-year}}
: Notifications are displayed otherwise {{see below|examples in table [[#et1|Error messages: Date parameters]]}}.

* {{bxtn|{{vanchor|birth2}}}}, alias {{bxtn|b2}}: Optional alternative birth-year. Depends on parameter {{bxtn|[[#or|or]]}} {{see below|there under [[#ord|Dependents]]}}.

* {{bxtn|{{vanchor|death2}}}}, alias {{bxtn|d2}}: Optional alternative death-year. Depends on parameter {{bxtn|[[#or|or]]}} {{see below|there under [[#ord|Dependents]]}}.

====Approximate dates: "Or" years, "circa" years====

* {{bxtn|{{vanchor|or}}}}: {{para|or|born[b]{{!}}died[d]{{!}}both[bd]}}
: Used for, and required by, optional alternative birth- and/or death-year(s). Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E41|notifications]] display when in error.
: {{em|Options:}}
: {{blist|{{para|or|born}} or the option alias <code>b</code>{{snd}} required when the alternative birth-year (parameter {{bxtn|birth2/b2}}) is included &#91;[[#b2x|example]]&#93; 
|{{para|or|died}} or <code>d</code>{{snd}} required when the alternative death-year (parameter {{bxtn|death2/d2}}) is included &#91;[[#d2x|example]]&#93;
|{{para|or|both}} or <code>bd</code>{{snd}} required when both alternative years are included &#91;[[#allxc|example]]&#93;}}
: {{em|Dependents:|id=ord}}
: {{blist|{{bxtn|birth2}}, alias {{bxtn|b2}}: {{para|birth2[b2]|{{var|yearnumber}}}}{{br}}Alternative birth-year, required when parameter {{para|or|born[b]}} or {{para|or|both[bd]}}. Enter {{em|only}} [[#as|a valid year value]] in full decimal notation according to century or millennium{{snd}} no other input is allowed. Must be chronologically later than parameter {{bxtn|birth/b}}. When parameter {{para|or|born[b]}}, it must be chronologically earlier than or equal parameter {{bxtn|death/d}}; when {{para|or|both[bd]}} it must be chronologically earlier than or equal parameter {{bxtn|death2/d2}}. [[#E14|Notifications]] will display when this parameter is in error.
|{{bxtn|death2}}, alias {{bxtn|d2}}: {{para|death[d2]|{{var|yearnumber}}}}{{br}}Alternative death-year, required when parameter {{para|or|died[d]}} or {{para|or|both[bd]}}. Enter {{em|only}} [[#as|a valid year value]] in full decimal notation according to century or millennium{{snd}} no other input is allowed. Must be chronologically later than all other date parameters; when parameter {{para|or|both[bd]}} it may equal parameter {{bxtn|birth2/b2}} &#91;[[#rxc|example]]&#93;. [[#E15|Notifications]] will display when this parameter is in error.}}
: {{em|Notes:}}
: {{blist|Parameter {{bxtn|or}} is not compatible with, and suppresses age-component parameter {{bxtn|[[#age-yrs|age-yrs/ay]]}}.
|{{vanchor|!orn2|text=Alternative years that do not match the selected {{bxtn|or}} option are silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#N03|a notice]] will display.}}
|{{vanchor|!orn3|text=Do not use parameter {{bxtn|or}} (as in {{para|or|both[bd]}}) to convey or combine a person's or entity's [[#as|postulated]] multiple discrete lifespans; such use may obfuscate the result and confuse the reader.}} For example, the alternative discrete lifespans:{{br}}{{spaces|5}}{{xt|{{lifespan |b=1975 |d=2015}}}} or {{xt|{{lifespan |b=1980 |d=2020}}}}{{br}}should not be combined into{{br}}{{spaces|5}}{{!xt|{{lifespan |b=1975 |d=2015 |or=bd |b2=1980 |d2=2020}}}}
|{{vanchor|!orn4|text=When {{para|or|both[bd]}} the alternative birth-year can be later than the death-year}} &#91;[[#rxc|example]]&#93;; the resulting visual or/and semantic incongruity will be [[#N04|noted]] if parameter {{bxtn|[[#msg|msg]]}} is used.}}

* {{bxtn|{{vanchor|circa}}}}, alias {{bxtn|ca}}: {{para|circa[ca]|born[b]{{!}}died[d]{{!}}both[bd]}}
: Use for [[#as|commonly accepted]] narrow estimates ([[wikt:circa|circa]] years) and the resulting age or range. Inserts the abbreviation/[[tooltip]] combination "{{abbr|c.|circa}}" followed by a non-breaking [[thin space]] before the relevant year (the tooltip appears only in the first instance of circa, i.e once per {{nobr|transclusion).{{efn|name=ca}}}} Requires valid all-numerical year values for parameters {{bxtn|[[#birth|birth/b]]}} and {{bxtn|[[#death|death/d]]}}. Cannot be specified for [[#ord|alternative years]]. This parameter is passed to the age component when it is included; if parameter {{bxtn|[[#age-range|age-range/ar]]}} is used, circa applies to the entire range regardless of the specific circa-year. Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used [[#E35|notifications]] display when in error.
: {{em|Options:}} 
: {{blist|{{para|circa|born}} or the option alias <code>b</code>{{snd}} set for circa birth-year(s) &#91;[[#cax|example]]&#93;
|{{para|circa|died}} or <code>d</code>{{snd}} set for circa death-year(s).
|{{para|circa|both}} or <code>bd</code>{{snd}} when both circa birth-year(s) and circa death-year(s) are used &#91;[[#allxc|example]]&#93;}}

====Era suffix<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->====

* {{bxtn|{{vanchor|suffix}}}}, alias {{bxtn|sfx}}: {{para|suffix[sfx]|<strong>ad</strong>{{!}}<strong>ce</strong>{{!}}bc{{!}}bce}} {{small|(implied preset options in <strong>bold</strong>)}}
: Use to display era suffix(es) preceded by non-breaking [[thin space]], and to implement era-straddling date spans {{see below|[[#sfxd|Dependents]]}}. The implied default era is [[AD]]|[[Common Era|CE]] across all {{nobr|dates.{{efn|name=zero}}}} There is no specific handling of [[Astronomical year numbering|astronomical dates]]; the template displays identical date spans for [[AD|BC/AD]] and [[Common Era|BCE/CE]] {{nobr|suffixes.{{efn|name=astro}}}} Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E51|notifications]] display when in error.
: See straddle-related [[#!sdln|note]] for description of certain unhandled exceptions.
: {{em|Options:|id=sfxo}}
: {{blist|{{para|suffix|ad}}{{snd}} explicitly states the default era (as "AD") &#91;[[#sfxx|example]]&#93;
|{{para|suffix|ce}}{{snd}} explicitly states the default era (as "CE")
|{{para|suffix|bc}}{{snd}} displays era as "BC" &#91;[[#ayx1|example]]&#93;
|{{para|suffix|bce}}{{snd}} displays era as "BCE"}}
: {{em|Suffix formats:}}
: {{blist|{{mxtn|No [[#ord|alternative years]]}}{{snd}} singular suffix displays after the date span &#91;[[#sfxx|example]]&#93;
|{{mxtn|Alternative years}}{{snd}} singular suffix displays after both birth and death years &#91;[[#d2x|example]]&#93;
|{{mxtn|[[#straddle|Era straddle]]}}{{snd}} complementary era suffixes display after both birth and death years &#91;[[#stradx|example]]&#93;}}
: {{em|Dependents:|id=sfxd}}
: {{blist|{{bxtn|{{vanchor|straddle}}}}, alias {{bxtn|sdl}}: {{para|straddle[sdl]|y}}{{br}}Conditional parameter, requires parameter {{bxtn|suffix}}. Displays complementary suffixes for spans that straddle eras (BC-to-AD or BCE-to-CE) between birth and {{nobr|death years &#91;[[#stradx|example]]&#93;.}}{{br}}Incorrect input is silently ignored and the date span is rendered according to the underlying era suffix instead; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E53|notifications]] display when in error.}}
:: {{em|Note:|id=!sdln}} Era straddles {{em|between}} birth years or {{em|between}} death years are not handled. For example, the span:{{br}}{{spaces|7}}{{nobr|[ {{!xt|10&#8201;BC or 5&#8201;AD{{snd}} 10&#8201;AD}} ]}}{{br}}cannot be rendered by the template

====Age component<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->====

Optional. Requires date parameters with valid, all-numerical year values. Consists of an editable text label and either parameter {{bxtn|age-range/ar}} or {{bxtn|age-yrs/ay}}. When used the subject's final age or age range(s) is auto-calculated and displayed after the date span or {{nobr|[[#suffix|the suffix]].{{efn|name=ac}}}} Parameter {{bxtn|age-label/al}} may be used to edit the component's label, and preset presentation parameter {{bxtn|[[#brackets|brackets/bkt]]}} may be reset to enclose the component in parentheses. Parameter {{bxtn|[[#circa|circa/ca]]}} is passed to the component when used, to indicate [[#as|commonly-accepted]] estimates.{{br}}
Autoinserted leading elements: A comma {{nobr|( {{bxtn|,}} )}} and single space, and the text "aged&#160;" (the term followed by a [[non-breaking space]]) as the component's preset default label. If the brackets are reset around the age component ({{para|brackets|age}}) no comma is inserted. The trailing static text "&#160;years" (the term preceded by a non-breaking space) is inserted before the closing bracket or as the last visible template element. When any birth-year equals any death-year the static text "less than a year" is displayed instead of the numerical age/range.

* {{bxtn|{{vanchor|age-range}}}}, alias {{bxtn|ar}}: {{para|age-range[ar]|y}}
: Set to display the subject's age range(s). Any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used [[#E61|notifications]] display when in error. Suppresses parameter {{bxtn|age-yrs/ay}}.
: {{em|Range formats:}}
: {{blist|{{mxtn|No [[#ord|alternative years]]}}{{snd}} the default. Range is two numerical values, the low value represents the death/end date occurring {{em|before}} the subject's birthday/startday in its death/end year. Values separated by an [[en dash]] {{nobr|( {{bxtn|&#8211;}} )}} &#91;[[#arx1|example]]&#93;
|{{mxtn|Alternative years}}{{snd}} range is delimited by the minimum and maximum possible ages defined by the date span(s); they are separated by the static text "&#160;to&#160;" ("to" surrounded by non-breaking spaces) &#91;[[#allxc|example]]&#93;
|{{mxtn|A birth/start year equals a death/end year}}{{snd}} the static text "less than a year" is displayed as the minimum range value if there are {{nobr|alternative years &#91;[[#rxc|example]]&#93;.}} Otherwise it displays as the only range value, also replacing the trailing static text "&#160;years"}}
:{{em|Dependents:}}
: {{blist|{{bxtn|age-label}}, alias {{bxtn|al}}: Please see ''[[#age-dep|Dependents]]'' under parameter {{bxtn|age-yrs/ay}}.}}

* {{bxtn|{{vanchor|age-yrs}}}}, alias {{bxtn|ay}}: {{para|age-yrs[ay]|abd{{!}}bbd}}
: Use when the subject's exact age or duration is known; may also be used with circa age/duration. Select [[#as|the appropriate]] predefined option, any other input is silently ignored. Incompatible with parameters {{bxtn|age-range/ar}} and {{bxtn|[[#or|or]]}} (and therefore with alternative years). If parameter {{bxtn|[[#msg|msg]]}} is used [[#E64|notifications]] display when in error.
: {{em|Options:}} 
: {{blist|{{para|age-yrs|abd}}{{snd}} set when the subject's death/end occurred after its birthday/startday in its death-year &#91;[[#ayx1|example]]&#93;
|{{para|age-yrs|bbd}}{{snd}} set when the subject's death/end occurred before its birthday/startday in its death-year &#91;[[#ayx2|example]]&#93;}}
: {{em|Dependents:|id=age-dep}}
: {{blist|{{bxtn|{{vanchor|age-label}}}}, alias {{bxtn|al}}: {{para|age-label[al]|<strong>aged</strong>{{!}}duration[dur]{{!}}none}} {{small|(preset option in <strong>bold</strong>)}}{{br}}Default parameter for the age component, use to reset or remove the preset label "aged&#160;". Requires one of parameters {{bxtn|age-range/ar}} or {{bxtn|age-yrs/ay}}. Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used [[#E63|notifications]] display when in error.}}
:: {{em|Options:}} 
:: {{blist|{{para|age-label|aged}}{{snd}} set to explicitly state the preset default.
|{{para|age-label|duration}} or the option alias <code>dur</code>{{snd}} set to change the label to "duration&#160;" (the term followed by a non-breaking space) &#91;[[#arx2|example]]&#93; 
|{{para|age-label|none}}{{snd}} set to remove the age component label &#91;[[#allxc|example]]&#93;}}

====Presentation: Brackets, content label and prefixes====

* {{bxtn|{{vanchor|brackets}}}}, alias {{bxtn|bkt}}: {{para|brackets[bkt]|age{{!}}<strong>full</strong>{{!}}none}} {{small|(preset option in <strong>bold</strong>)}}
: Default parameter. Preset to enclose the entire template output in brackets (parentheses) as its first and last visible elements. Predefined options may override or explicitly state the preset, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E31|notifications]] display when in error.
: {{em|Options:}}
: {{blist|{{para|brackets|age}}{{snd}} set to display brackets around the age component only &#91;[[#allxc|example]]&#93;. If the component is omitted or in error default brackets will display
|{{para|brackets|full}}{{snd}} set to explicitly state the preset default
|{{para|brackets|none}}{{snd}} set to remove all brackets &#91;[[#bktx|example]]&#93;}}

* {{bxtn|{{vanchor|label}}}}, alias {{bxtn|l}}: {{para|label[l]|lc{{!}}uc}}
: Use to display the static text "lifespan:&#160;" (the term followed by colons and a [[non-breaking space]]) as the label for the template's content. Displays immediately after the opening bracket, or first if brackets are removed. Suppressed when parameter {{bxtn|[[#prefix|prefix/pfx]]}} is included. Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E32|notifications]] display when in error.
: {{em|Options:}}
: {{blist|{{para|label|lc}}{{snd}} set to display the label in lowercase &#91;[[#lx|example]]&#93;
|{{para|label|uc}}{{snd}} set to display the label with initial-letter uppercase &#91;[[#allxc|example]]&#93;}}

* {{bxtn|{{vanchor|prefix}}}}, alias {{bxtn|pfx}}: {{para|prefix[pfx]|tt{{!}}nt}}
: Use to display the abbreviated prefixes "b." (born) and "d." (died) followed by a non-breaking [[thin space]] before the birth and death years or before parameter {{bxtn|[[#circa|circa]]}}. Suppresses parameter {{bxtn|[[#label|label/l]]}}. Select a predefined option, any other input is silently ignored; if parameter {{bxtn|[[#msg|msg]]}} is used, [[#E41|notifications]] display when in error.
: {{em|Options:}}
: {{blist|{{para|prefix|tt}}{{snd}} set to display the prefixes with hovering [[tooltip]]s: {{abbr|b.|born}} {{nobr|and {{abbr|d.|died}}{{efn|name=tts}}}} &#91;[[#pfxx|example]]&#93;
|{{para|prefix|nt}}{{snd}} set to display the prefixes only (no tooltips), preferable in lists with multiple transclusions &#91;[[#rxc|example]]&#93;}}

====Notification handling====

* {{bxtn|{{vanchor|msg}}}}: {{para|msg|y}}
: Optional, intended for testing and debugging purposes; to pre-validate template application, use of this parameter is recommended during preview. Checks non-date parameters (this parameter included) for error conditions and displays related notifications, and also displays maintenance-related notifications for any parameter.
: In addition, notifications for unrecognized parameters (including misspellings) will [[#N01|be displayed]]. Notifications display first, before any other template output. Any and all such messaging will appear upon transclusion; handling of individual or per-parameter notifications is not supported. Incorrect input for {{bxtn|msg}} will suppress all notifications except [[#E101|the notification]] for itself; mislabeling the parameter will additionally suppress its own {{nobr|notification.{{efn|name=err-chk}}}}

==Errors and notifications<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->==

The template handles several types of error and maintenance conditions, including fatal errors, usage-related issues, constraint violations and unrecognized parameters. The conditions (and/or the notifications) may suppress display of related template elements and may produce unexpected, incomplete, or incoherent output.{{br}}
Fatal errors stop template processing and the related notification message suppresses any other template output. Non-fatal notifications display before any other output.{{br}}
Any parameter may generate notifications. Error notifications generated by [[#Date spans: Birth- and death-year, alternative birth- and death-year|date parameters]] (including alternative-year parameters) are always displayed; so are dating errors introduced by misapplying other parameters. In any such error case the edited page will be added to {{fake link|Category:Template Lifespan errors|Category does not exist yet}}. If either of parameters {{bxtn|[[#birth|birth/b]]}} and {{bxtn|[[#death|death/d]]}} is absent, mislabeled, or has no value the error is fatal.{{br}}
Notifications for non-date-parameter error conditions, maintenance issues for any parameter, and for {{vanchor|???|text=unrecognized parameters are not displayed by default; the input error values and in some cases the error conditions are ignored}}. Parameter {{bxtn|[[#msg|msg]]}} may be used to display these notifications; when {{bxtn|msg}} itself is in error its message or condition suppresses all other {{nobr|notifications.{{efn|name=err-chk}}}}{{br}}
Notifications are delimited by exclamation marks {{nobr|( {{bxtn|!}} )}} and are grouped and numbered according to context; the numbering may not be strictly sequential. Error messages display mostly in <span style="color:red">red text</span>, other notices in <span style="color:gray">gray text</span>. 

{| class="wikitable sortable mw-collapsible mw-collapsed floatleft col1center col2center" style="width:85%; margin:auto" id="et1"
|+ style="border:1px solid black; text-align:center"|{{color|red|Error messages}}: Date parameters
!{{abbr|No.|Number}}!!Type!!class="unsortable"|Message!!class="unsortable"|Link
|-
|style=text-align:center id=F01|F01||style=text-align:center|[fatal error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|birth/b}}}} is missing, mislabeled, or has no value {{strong|!}}||style=text-align:center|&#91;[[#birth|info]]&#93;
|-
|style=text-align:center id=F02|F02||style=text-align:center|[fatal error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|death/d}}}} is missing, mislabeled, or has no value {{strong|!}}||style=text-align:center|&#91;[[#death|info]]&#93;
|-
|style=text-align:center id=E11|E11||style=text-align:center|{{nobr|[usage error]}}||style=color:red|{{strong|! Birth-year}} has invalid value {{strong|!}}||style=text-align:center|&#91;[[#birth|info]]&#93;
|-
|style=text-align:center id=E12|E12||style=text-align:center|[usage error]||style=color:red|{{strong|! Death-year}} has invalid value {{strong|!}}||style=text-align:center|&#91;[[#death|info]]&#93;
|-
|style=text-align:center id=E13|E13||style=text-align:center|[constraint]||style=color:red|{{strong|! Birth-year}} must be earlier than or equal the death-year {{strong|!}}||style=text-align:center|&#91;[[#birth|info]]&#93;
|-
|style=text-align:center id=E14|E14||style=text-align:center|[constraint]||style=color:red|{{strong|! Birth-year}} must be earlier than the alternative birth-year {{strong|!}}||style=text-align:center|&#91;[[#birth|info]]&#93;
|-
|style=text-align:center id=E15|E15||style=text-align:center|[constraint]||style=color:red|{{strong|! Death-year}} must be earlier than the alternative death-year {{strong|!}}||style=text-align:center|&#91;[[#death|info]]&#93;
|-
|style=text-align:center id=E16|E16||style=text-align:center|[constraint]||style=color:red|{{strong|! Birth-year}} must be earlier than the alternative death-year {{strong|!}}||style=text-align:center|&#91;[[#birth|info]]&#93;
|-
|style=text-align:center id=E21|E21||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|birth2/b2}}}} is missing, mislabeled or has no value {{strong|!}}||style=text-align:center|&#91;[[#birth2|info]]&#93;
|-
|style=text-align:center id=E22|E22||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|death2/d2}}}} is missing, mislabeled or has no value {{strong|!}}||style=text-align:center|&#91;[[#death2|info]]&#93;
|-
|style=text-align:center id=E23|E23||style=text-align:center|[usage error]||style=color:red|{{strong|! Alternative birth-year}} has invalid value {{strong|!}}||style=text-align:center|&#91;[[#birth2|info]]&#93;
|-
|style=text-align:center id=E24|E24||style=text-align:center|[usage error]||style=color:red|{{strong|! Alternative death-year}} has invalid value {{strong|!}}||style=text-align:center|&#91;[[#death2|info]]&#93;
|-
|style=text-align:center id=E25|E25||style=text-align:center|[constraint]||style=color:red|{{strong|! Alternative birth-year}} requires parameter {{strong|{{color|green|or}} !}}||style=text-align:center|&#91;[[#birth2|info]]&#93;
|-
|style=text-align:center id=E26|E26||style=text-align:center|[constraint]||style=color:red|{{strong|! Alternative death-year}} requires parameter {{strong|{{color|green|or}} !}}||style=text-align:center|&#91;[[#death2|info]]&#93;
|-
|style=text-align:center id=E27|E27||style=text-align:center|[constraint]||style=color:red|{{strong|!}} When there is no alternative death-year, the {{strong|alternative birth-year}} must be earlier than or equal the death-year {{strong|!}}||style=text-align:center|&#91;[[#birth2|info]]&#93;
|-
|style=text-align:center id=E28|E28||style=text-align:center|[constraint]||style=color:red|{{strong|! Alternative birth-year}} must be earlier than or equal the alternative death-year {{strong|!}}||style=text-align:center|&#91;[[#birth2|info]]&#93;
|-
|style=text-align:center id=E30|E30||style=text-align:center|[usage error]||style=color:red|{{strong|!}} {{strong|Year 0 (zero)}} era may only be {{color|green|CE}} {{strong|!}}||style=text-align:center|&#91;[[#suffix|info]]&#93;
|}
{| class="wikitable sortable mw-collapsible mw-collapsed floatleft col1center col2center" style="width:85%; margin:auto" id=et2
|+ style="border:1px solid black; text-align:center"|{{color|red|Error messages}}: Non-date parameters
!{{abbr|No.|Number}}!!Type!!class="unsortable"|Message!!class="unsortable"|Link
|-
|style=text-align:center id=E31|E31||style=text-align:center|{{nobr|[usage error]}}||style=color:red|{{strong|!}} Invalid {{strong|brackets option}} value {{strong|!}}||style=text-align:center|&#91;[[#brackets|info]]&#93;
|-
|style=text-align:center id=E32|E32||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|content label option}} value {{strong|!}}||style=text-align:center|&#91;[[#label|info]]&#93;
|-
|style=text-align:center id=E33|E33||style=text-align:center|[constraint]||style=color:red|{{strong|! Content label}} cannot be used when prefixes are used {{strong|!}}||style=text-align:center|&#91;[[#label|info]]&#93;
|-
|style=text-align:center id=E34|E34||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|prefix option}} value {{strong|!}}||style=text-align:center|&#91;[[#prefix|info]]&#93;
|-
|style=text-align:center id=E35|E35||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|circa option}} value {{strong|!}}||style=text-align:center|&#91;[[#circa|info]]&#93;
|-
|style=text-align:center id=E36|E36||style=text-align:center|[constraint]||style=color:red|{{strong|! Circa year(s)}} require all-numerical value(s) {{strong|!}}||style=text-align:center|&#91;[[#circa|info]]&#93;
|-
|style=text-align:center id=E41|E41||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|or}}}} invalid option value {{strong|!}}||style=text-align:center|&#91;[[#or|info]]&#93;
|-
|style=text-align:center id=E51|E51||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|suffix option}} value {{strong|!}}||style=text-align:center|&#91;[[#suffix|info]]&#93;
|-
|style=text-align:center id=E53|E53||style=text-align:center|[constraint]||style=color:red|{{strong|! Era straddle}} requires a suffix {{strong|!}}||style=text-align:center|&#91;[[#straddle|info]]&#93;
|-
|style=text-align:center id=E54|E54||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|era straddle}} value {{strong|!}}||style=text-align:center|&#91;[[#straddle|info]]&#93;
|-
|style=text-align:center id=E60|E60||style=text-align:center|[constraint]||style=color:red|{{strong|! Age component}} requires all-numerical year values {{strong|!}}||style=text-align:center|&#91;[[#Age component|info]]&#93;
|-
|style=text-align:center id=E61|E61||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|age range}} value {{strong|!}}||style=text-align:center|&#91;[[#age-range|info]]&#93;
|-
|style=text-align:center id=E62|E62||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|age option}} value {{strong|!}}||style=text-align:center|&#91;[[#age-yrs|info]]&#93;
|-
|style=text-align:center id=E63|E63||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Invalid {{strong|age label option}} value {{strong|!}}||style=text-align:center|&#91;[[#age-label|info]]&#93;
|-
|style=text-align:center id=E64|E64||style=text-align:center|[constraint]||style=color:red|{{strong|!}} The {{strong|age}} cannot be rendered when alternative years are used {{strong|!}}||style=text-align:center|&#91;[[#age-yrs|info]]&#93;
|-
|style=text-align:center id=E65|E65||style=text-align:center|[constraint]||style=color:red|{{strong|!}} The {{strong|age}} cannot be rendered when the age range is used {{strong|!}}||style=text-align:center|&#91;[[#age-yrs|info]]&#93;
|-
|style=text-align:center id=E66|E66||style=text-align:center|[constraint]||style=color:red|{{strong|! Age label}} requires the age or range {{strong|!}}||style=text-align:center|&#91;[[#age-label|info]]&#93;
|-
|style=text-align:center id=E101|E101||style=text-align:center|[usage error]||style=color:red|{{strong|!}} Parameter {{strong|{{color|green|msg}}}} invalid value {{strong|!}}||style=text-align:center|&#91;[[#msg|info]]&#93;
|}
{| class="wikitable sortable mw-collapsible mw-collapsed floatleft col1center col2center" style="width:85%; margin:auto" id=nt1
|+ style="border:1px solid black; text-align:center"|{{color|gray|Notices}}
!{{abbr|No.|Number}}!!Type!!class="unsortable"|Notice!!class="unsortable"|Link
|-
|style=text-align:center id=N01|N01||style=text-align:center|[usage]||style=color:gray|{{strong|!}} Unrecognized parameter name {{strong|{{color|red|{{var|<parameter name>}}}} !}}||style=text-align:center|&#91;[[#???|info]]&#93; 
|-
|style=text-align:center id=N02|N02||style=text-align:center|[maintenance]||style=color:gray|{{strong|!}} Year 0 (zero) without explicit {{strong|suffix option}} "{{color|green|ce}}" ([[Common Era|CE]] implied) {{strong|!}}||style=text-align:center|&#91;[[#suffix|info]]&#93;
|-
|style=text-align:center id=N03|N03||style=text-align:center|[maintenance]||style=color:gray|{{strong|!}} Superfluous {{strong|alternative year !}}||style=text-align:center|&#91;[[#!orn2|info]]&#93;
|-
|style=text-align:center id=N04|N04||style=text-align:center|[usage]||style=color:gray|{{strong|! Alternative birth-year}} later than death-year {{strong|!}}||style=text-align:center|&#91;[[#!orn4|info]]&#93;
|}
{{clear}}

<!--
==Categorization==

* {{cl|Category:Template Lifespan errors}}{{snd}} date-related errors add the edited page to this category
-->
==TemplateData<!--This section heading is linked from within this page ([[MOS:HEAD]]).-->==

{{TemplateData header}}
<templatedata>
{
	"params": {
		"birth": {
			"aliases": [
				"b"
			],
			"label": "Birth/Start",
			"required": true,
			"type": "string",
			"suggestedvalues": [
				"uncertain",
				"unknown"
			],
			"description": "The birth/start/origin year. Enter only the full year number in decimals according to century or millennium; for ambiguous or unknown birth years select one of the dropdown list options"
		},
		"death": {
			"aliases": [
				"d"
			],
			"label": "Death/End",
			"required": true,
			"type": "string",
			"suggestedvalues": [
				"uncertain",
				"unknown"
			],
			"description": "The death/end/final year. Enter only the full year number in decimals according to century or millennium; for ambiguous or unknown death years select one of the dropdown list options"
		},
		"or": {
			"label": "Or",
			"type": "string",
			"suggestedvalues": [
				"born",
				"died",
				"both"
			],
			"description": "Required when using alternative birth and/or death years. Not compatible with 'Age (years)'. Must enter (in lowercase) or select from the dropdown list, the option matching the alternative year(s)"
		},
		"birth2": {
			"aliases": [
				"b2"
			],
			"label": "Alternative birth/start",
			"type": "date",
			"description": "Alternative birth-year. Requires parameter 'Or' with option 'born' or 'both'; must be chronologically later than 'Birth/Start'; when there is no alternative death-year it must be chronologically earlier or equal to 'Death/End'. Enter only the full year number in decimals according to century or millennium"
		},
		"death2": {
			"aliases": [
				"d2"
			],
			"label": "Alternative death/end",
			"type": "date",
			"description": "Alternative death-year. Requires parameter 'Or' with option 'died' or 'both'; must be chronologically later than 'Death/End'. Enter only the full year number in decimals according to century or millennium"
		},
		"suffix": {
			"aliases": [
				"sfx"
			],
			"label": "Era suffix",
			"type": "string",
			"suggestedvalues": [
				"ad",
				"bc",
				"bce",
				"ce"
			],
			"default": "ad",
			"description": "Displays any of AD/BC/BCE/CE suffixes after the date span; when there are alternative years or era straddles suffixes display after both birth and death years. Required by 'Era straddle'. Select the relevant option from the dropdown list or type-in (lowercase). Implied default is AD|CE. Notations BC/AD and BCE/CE are functionally identical"
		},
		"straddle": {
			"aliases": [
				"sdl"
			],
			"label": "Era straddle",
			"type": "boolean",
			"default": "y",
			"description": "Use when the date span straddles different eras (BC-to-AD or BCE-to-CE); displays the complementary suffixes after the birth and death years. Requires 'Era suffix'. Set to 'y' (lowercase, no quote-marks)"
		},
		"circa": {
			"aliases": [
				"ca"
			],
			"label": "Circa",
			"type": "string",
			"suggestedvalues": [
				"born",
				"died",
				"both"
			],
			"description": "Use for narrowly-estimated (circa) birth and/or death years; passed to the age/range if present. Requires numerical year values; type-in (lowercase) or select from the dropdown list, the option matching the circa year(s)"
		},
		"prefix": {
			"aliases": [
				"pfx"
			],
			"label": "Prefixes",
			"type": "string",
			"suggestedvalues": [
				"nt",
				"tt"
			],
			"description": "Displays the abbreviated prefixes 'b.' and 'd.' before the birth and death year(s); suppresses 'Content label'. Type-in (lowercase, no quote-marks) or select from the dropdown list, option 'tt' to add hovering tooltip text ('born' or 'died'), else enter 'nt' for plain text (no tooltips)"
		},
		"age-yrs": {
			"aliases": [
				"ay"
			],
			"label": "Age (years)",
			"type": "string",
			"suggestedvalues": [
				"abd",
				"bbd"
			],
			"description": "Auto-calculates and displays the subject's exact age or a narrow estimate (with parameter 'Circa'). Requires numerical year values. Cannot be used with 'Or' or 'Age (range)'. Type-in (lowercase, no quote-marks) or select from the dropdown list, option 'abd' if the subject's death/end occurred after its birthday/startday in its death year, 'bbd' otherwise"
		},
		"age-range": {
			"aliases": [
				"ar"
			],
			"label": "Age (range)",
			"type": "boolean",
			"default": "y",
			"description": "Set to 'y' (lowercase, no quote-marks) to display the subject's age range(s) (add parameter 'Circa' for estimates). Requires numerical year values. Cannot be used with 'Age (years)'"
		},
		"age-label": {
			"aliases": [
				"al"
			],
			"label": "Age label",
			"type": "string",
			"suggestedvalues": [
				"aged",
				"duration",
				"none"
			],
			"autovalue": "aged",
			"description": "Label before the age or range, requires either 'Age (years)' or 'Age (range)'. Preset default is 'aged'; type-in (lowercase, no quote-marks) or select from the dropdown list, an option to reset or restate ('none' removes the age label)"
		},
		"label": {
			"aliases": [
				"l"
			],
			"label": "Content label",
			"type": "string",
			"suggestedvalues": [
				"lc",
				"uc"
			],
			"description": "Displays 'lifespan: ' as label for the template content; will not display when 'Prefixes' is used. Type-in (lowercase, no quote-marks) or select from the dropdown list option 'lc' for all-lowercase label, 'uc' for initial-letter uppercase"
		},
		"brackets": {
			"aliases": [
				"bkt"
			],
			"label": "Brackets",
			"type": "string",
			"suggestedvalues": [
				"age",
				"none",
				"full"
			],
			"autovalue": "full",
			"description": "Parentheses, enclose the full output by default (preset to 'full'). To display brackets around the age/range only, type-in 'age' (lowercase, no quote-marks) or select it from the dropdown list; 'none' removes brackets altogether"
		},
		"msg": {
			"label": "Notification display",
			"type": "boolean",
			"default": "y",
			"description": "Set to 'y' (lowercase, no quote-marks) to display notifications related to non-date parameters, and any maintenance messages; may suppress display of related template elements; use to test template output during preview"
		}
	},
	"description": "This template may be used to display (within removable parentheses) a person's or entity's singular, whole lifespan in years and optionally their final age or duration, also in years; the Gregorian calendar and AD|CE era are respectively, the implied default calendar and editable default era. Other calendars, and astronomical dates, may be adapted to the template. Negative years are not allowed. Year 0 (zero) may be used when applicable. All date-related input must be provided by acceptable sources. When entered manually, all predefined options must be in lowercase, without quote-marks. For details and examples see the template's documentation. Parameter list order reflects relative importance.",
	"paramOrder": [
		"birth",
		"death",
		"or",
		"birth2",
		"death2",
		"suffix",
		"straddle",
		"circa",
		"prefix",
		"age-yrs",
		"age-range",
		"age-label",
		"label",
		"brackets",
		"msg"
	]
}
</templatedata>

==Footnotes==
<!--Listed alphanumerically by note name (printable ASCII).-->

{{notelist|refs=
{{efn|name=ac|1=Template {{tlx|age}} is used to calculate ages and range(s).}}
{{efn|name=astro|1=[[Common Era]] (BCE/CE) suffixes may be used to adapt astronomical date numbering to the template (substituting negative years, which return an error).}}
{{efn|name=ca|1=Template {{tlx|circa}} is used to display circa years.}}
{{efn|name=cals|1=[[#Era suffix|Era suffixes]] used in this template, or the age component, may not be compatible with or appropriate for non-Gregorian calendars.}}
{{efn|name=equal|1=When the subject's final age or duration is less than a year.}}
{{efn|name=err-chk|1=When the edited page contains a large number of {{tlx|lifespan|nolink=y}} transclusions with {{para|msg|y}}, a small performance cost may be incurred.}} 
{{efn|name=logic|1=Rudimentary description of the template's logic may be found in {{slink|Template talk:Lifespan|Logic}}.}}
{{efn|name=temp|1=Temporary or place-holding parameters are not bound by the naming requirements and may be undocumented.}}
{{efn|name=tts|1=Template {{tlx|abbr}} is used to display tooltips.}}
{{efn|name=years|1=Template {{tlx|YEAR}} is used to apply numerical year value conformance.}}
{{efn|name=zero|1=Year 0 (zero) does not exist in BC/AD eras and should be used with the CE suffix only (this suffix is implied and its explicit use is optional). Invalid era suffixes will generate [[#E30|an error message]]. When no suffix is present, and if [[#msg|optional error checking]] is used, [[#N02|a maintenance notice]] will display.}}
}}
<includeonly>{{Sandbox other||<!-- Categories below this line -->
[[Category:Date mathematics templates]]
}}</includeonly>