View source for Template:Birth-date and age/doc

[[Image:BadSalzdetfurthBadenburgerStr060529.jpg|right|80px]]
{{tsh|b-da}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

Returns a person's date of birth and age.

Besides calculating the age of the person, 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:
: <code><nowiki>{{Birth-date and age| birth date}}</nowiki></code>
: <code><nowiki>{{Birth-date and age| birth date | wikitext to display in place of 'birth date'.  Like the right hand parameter in a wikilink, this could be alternate text, links, templates etc. }}</nowiki></code>

==== Examples ====
{| width="100%" xclass="toccolours" style="margin-top:.5em;border:1px solid #a0a0a0;background-color:#f8f8ff;" <!-- no class formatting other than article space -->
|- style="text-align:left;" colspan=2
|'''<span style="font-size:110%;">Birth-date and age examples </span>''' ''(colors for emphasis only)'':
|- style="text-align:left;line-height:1.4em;font-size:87%;"
|style="white-space:normal;"|'''Month first format: Sample below displays <span style="color:#038945;">{{Birth-date and age|April 12, 1941}}</span>, with invisible microformat date: '''''1941-04-12''<br />
<code><nowiki>{{birth-date and age|</nowiki><nowiki>April 12, 1941</nowiki>}}<br />
|- style="text-align:left;line-height:1.4em;font-size:87%;"
|style="white-space:normal;"|'''Day first format: Sample below displays <span style="color:#038945;">{{Birth-date and age| 12 April 1941}}</span>, with invisible microformat date: '''''1941-04-12''<br />
<code><nowiki>{{Birth-date and age| 12 April 1941 </nowiki>}}<br />
|- style="text-align:left;line-height:1.4em;font-size:87%;"
|style="white-space:normal;"|'''Year only, year and month only: Sample below displays <span style="color:#038945;">{{Birth-date and age|1941}}</span>, with invisible microformat date: '''''1941''<br />
<code><nowiki>{{Birth-date and age | 1941 </nowiki>}}<br />
|- style="text-align:left;line-height:1.4em;font-size:87%;"
|style="white-space:normal;"|'''Demo of ISO date, as well as alternate displays.  Sample below displays <span style="color:#038945;">{{Birth-date and age| 1941-04-12 |Twelfth of April, 1941}}</span>, with invisible microformat date: '''''1941-04-12''<br />
<code><nowiki>{{Birth-date and age| 1941-04-12 |</nowiki> Twelfth of April, 1941}}<br />
|}

=== Full list of Parameters ===
: <code><nowiki>{{birth-date and age|</nowiki></code>''birth date''<tt>|''additional parameters''}}</tt>

===Parameters===
{| class="wikitable" style="font-size:95%;"
!colspan="3" style="padding-left:64px;text-align:left;"| Parameter !! Default
|-
|width="60" style="vertical-align:top;"| (required) ||width="120" style="vertical-align:top;" align="center" | 1 || Birth 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 birth 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 2. || align="center" style="vertical-align:top;"| &ndash;
|-
|width="60" style="vertical-align:top;"| (optional) ||width="120" style="vertical-align:top;" align="center" | 2 || The birth date to display.  This may include links or templates, or any combination of them, and overrides parameter 1.  || align="center" style="vertical-align:top;"| parm 1
|-
|style="vertical-align:top;"| (optional) ||style="vertical-align:top;" align="center"| bce || If birth date is BC, set to "''b''".  ||align="center" style="vertical-align:top;"| &ndash;
|-
|style="vertical-align:top;"| (optional) ||style="vertical-align:top;" align="center"| gregorian || If Julian date is used, this parameter is required.  The date provided is used for emitting the correct microformat translation of the birth date.  ||align="center" style="vertical-align:top;"| parm 1
|-
|style="vertical-align:top;"| (optional) ||style="vertical-align:top;" align="center"| dt  || This value if present is the [[ISO8601]] value emitted to indicate microformat birth date.  It overrides any calculated value. ||align="center" style="vertical-align:top;"| &ndash;
|}

=== Interaction side-effects with other templates ===

'''Note:''' Do not use this template inside of the [[WP:PERSONDATA|Persondata]] template as it can interfere with data extraction.

=== See also ===

*[[Wikipedia:Age calculation templates]]
{{Birth, death and age templates}}
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Date mathematics templates|Birth-date and age]]
[[Category:Templates generating microformat date and age|{{BASEPAGENAME}}]]
</includeonly>[[Category:Templates]]