Changes
→Examples: show microformat output differences for the 3 templates documented here
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
{{#switch:{{PAGENAME}}
| Start-date = {{High-use|4900}}
| Birth-date = {{High-use|16000}}
| End-date = {{High-use|10000}}
}}
{{Intricate template}}
[[File:BadSalzdetfurthBadenburgerStr060529.jpg|right|80px]]
{{tl|Start-date}}, {{tl|Birth-date}}, and {{tl|End-date}} (also used as {{tl|Death-date}}) are easy to read "plain text" date and time templates that emit [[microformat]] dates for events. These templates are an alternative to the {{tl|Start date}}/{{tl|Birth date}} and {{tl|End date}}/{{tl|Death date}} templates that also emit microformats but require dates to be expressed in standard, unambiguous and international ISO syntax. "Fuzzy" dates and times are supported. For events where the precise time, day or month is not known, the user may omit these details. Time zones are assumed to be local to the event. If time zone information is specified, the otherwise optional timezone parameter must be set.
== Examples ==
{| width="100%" xclass="toccolours" style="margin-top:.5em; border:1px solid #a0a0a0; background-color:#f8f8ff;" <!-- no class formatting other than article space -->
|+ '''<span style="font-size:110%;">Examples of {{tl|Start-date}}, {{tl|Birth-date}}, and {{tl|End-date}}</span>''' ''(colors for emphasis only)''
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below display <span style="color:#038945;">{{start-date|7 December 1941}}</span>, and emit hidden microformat date: '''''1941-12-07''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}}</code> → {{start-date|7 December 1941}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}}</code> → {{birth-date|7 December 1941}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}} </code> → {{end-date|7 December 1941}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate how days, timezones and hours, minutes and seconds can be shown (order often not important). Displays <span style="color:#038945;">{{start-date|5:43PM HST, December 7th, 1941|tz=y}}</span>, and emits hidden microformat date (corrected for UTC): '''''1941-12-08T03:43Z''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}}</code> → {{start-date|5:43PM HST, December 7th, 1941|tz=y}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}}</code> → {{birth-date|5:43PM HST, December 7th, 1941|tz=y}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}} </code> → {{end-date|5:43PM HST, December 7th, 1941|tz=y}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate providing a location with local time to generate UTC value. Displays <span style="color:#038945;">{{start-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}</span>, and emits hidden microformat date (corrected for UTC): '''''1941-12-08 T03:20Z''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}}</code> → {{start-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}}</code> → {{birth-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}} </code> → {{end-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate use of Julian calendar dates. Displays <span style="color:#038945;">{{start-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}</span>, and emits hidden microformat date: '''''1672-06-09''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}}</code> → {{start-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}}</code> → {{birth-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}} </code> → {{end-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
|}
=== Microformat output ===
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{Start-date|31 December 2016}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{Birth-date|31 December 2016}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{End-date|31 December 2016}}</nowiki>}}
== Parameters ==
;''parameter 1'': (required) The date and time to display and to emit as a microformat date. If year is absent, the current year is assumed. If day is missing, the first of the month is assumed. If hour, or minutes are missing, zero is assumed. If time zone or location is missing, the local time of the event discussed in the article is assumed. See timezone parameter if [[UTC]] time is desired. Authors may specify place names ([[Template:Start-date/doc/timezones|see list]]) or time zones such as EDT, PST, HST and so on and these will be properly adjusted to [[UTC| UTC (Coordinated Universal Time)]] for transfer to other applications via microformat encoding. Gregorian calendar dates are required. Display in Julian or Chinese calendar date is possible using parameter 2.
<!--;''parameter 2'' (optional): If present, this wikitext is displayed rather than the date in parameter 1. These might be links to day of month or year pages. EG. December 7, 1941
commenting out deprecated practice -->
;ISO8601: (optional) if present, this ISO8601 date/time value is emitted instead of the value derived from parameter 1.
;BCE: (required for BCE dates) set to yes if the date is BC.
;timezone
;tz: (required if timezone information specified) Set to yes if the time is [[UTC]] or if the location, timezone, or timezone offset is specified.
==TemplateData==
{{TemplateDataHeader}}
<templatedata>
{
"params": {
"1": {},
"2": {},
"ISO8601": {},
"dt": {},
"display": {},
"timezone": {},
"tz": {
"description": "set to \"yes\" when timezone is present, or when timzone UTC is implicit",
"type": "boolean"
},
"BCE": {},
"BC": {},
"class-extra": {},
"df": {}
},
"paramOrder": [
"1",
"2",
"ISO8601",
"dt",
"tz",
"timezone",
"BCE",
"BC",
"display",
"class-extra",
"df"
]
}
</templatedata>
== Ambiguous times and dates ==
For the years 99 BC to 99AD especially, microformats may not be emitted properly unless expressed in the form YYYY-MM-DD. For users uninterested in microformats, it should be noted that this restriction has no known impacts other than microformat data which are currently invisible to users. The user of course may express the display form in the second parameter however they would like. Example: 1-2-3 is interpreted as February 3, 1 A.D, and emitted in that form via microformats when the user may have intended something else. Other 3 digit years may be misinterpreted as well, so best practice is to use leading zeros to make a 4 digit year for this date range. For example, February 274 will be interpreted as February 27, 2004. Instead, use "February 0274". Background: There is a good rationale for the behavior of the system function which actually does the hard work of this template. It is very unusual for people to mention such dates so long ago, so when we really mean this date, we must specify a 4 digit date. Outside of this period with ambiguous years, users may use free text dates without this restriction. Bot runs may make a conversion of non 4 digit years to 4 digits (with leading zeros) in order to refine Wikipedia's quality of microformat dates. These changes will not affect display, but for those curious, this is the rationale for such bot manipulations.
== Time zones ==
Most time zone abbreviations as well as a large number of place names are recognized. (See [[Template:Start-date/doc/timezones|recognized timezone values table]].)
:<code><nowiki>{{start-date|December 7, 1941 8:43AM Pacific/Honolulu }}</nowiki></code> → '''{{start-date|December 7, 1941 8:43AM Pacific/Honolulu }}'''
:<code><nowiki>{{start-date|December 8, 1941 12:30PM Asia/Manila }}</nowiki></code> → '''{{start-date|December 8, 1941 12:30PM Asia/Manila }}'''
== See also ==
{{Birth, death and age templates |dates}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Date mathematics templates]]
[[Category:Templates generating microformat dates]]
[[Category:Templates generating hCalendars|{{subst:PAGENAME}}]]
}}</includeonly>
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
{{#switch:{{PAGENAME}}
| Start-date = {{High-use|4900}}
| Birth-date = {{High-use|16000}}
| End-date = {{High-use|10000}}
}}
{{Intricate template}}
[[File:BadSalzdetfurthBadenburgerStr060529.jpg|right|80px]]
{{tl|Start-date}}, {{tl|Birth-date}}, and {{tl|End-date}} (also used as {{tl|Death-date}}) are easy to read "plain text" date and time templates that emit [[microformat]] dates for events. These templates are an alternative to the {{tl|Start date}}/{{tl|Birth date}} and {{tl|End date}}/{{tl|Death date}} templates that also emit microformats but require dates to be expressed in standard, unambiguous and international ISO syntax. "Fuzzy" dates and times are supported. For events where the precise time, day or month is not known, the user may omit these details. Time zones are assumed to be local to the event. If time zone information is specified, the otherwise optional timezone parameter must be set.
== Examples ==
{| width="100%" xclass="toccolours" style="margin-top:.5em; border:1px solid #a0a0a0; background-color:#f8f8ff;" <!-- no class formatting other than article space -->
|+ '''<span style="font-size:110%;">Examples of {{tl|Start-date}}, {{tl|Birth-date}}, and {{tl|End-date}}</span>''' ''(colors for emphasis only)''
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below display <span style="color:#038945;">{{start-date|7 December 1941}}</span>, and emit hidden microformat date: '''''1941-12-07''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}}</code> → {{start-date|7 December 1941}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}}</code> → {{birth-date|7 December 1941}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''<nowiki>7 December 1941</nowiki>''</span>}} </code> → {{end-date|7 December 1941}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate how days, timezones and hours, minutes and seconds can be shown (order often not important). Displays <span style="color:#038945;">{{start-date|5:43PM HST, December 7th, 1941|tz=y}}</span>, and emits hidden microformat date (corrected for UTC): '''''1941-12-08T03:43Z''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}}</code> → {{start-date|5:43PM HST, December 7th, 1941|tz=y}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}}</code> → {{birth-date|5:43PM HST, December 7th, 1941|tz=y}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''5:43PM [[Hawaii-Aleutian time zone|HST]], December 7th, 1941''|tz=y</span>}} </code> → {{end-date|5:43PM HST, December 7th, 1941|tz=y}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate providing a location with local time to generate UTC value. Displays <span style="color:#038945;">{{start-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}</span>, and emits hidden microformat date (corrected for UTC): '''''1941-12-08 T03:20Z''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}}</code> → {{start-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}}</code> → {{birth-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''December 8, 1941 12:50PM Australia/[[Adelaide]]|tz=y''</span>}} </code> → {{end-date|December 8, 1941 12:50PM Australia/Adelaide|tz=y}}
|- style="text-align:left; line-height:1.4em;"
| style="white-space:normal;" | '''Samples below demonstrate use of Julian calendar dates. Displays <span style="color:#038945;">{{start-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}</span>, and emits hidden microformat date: '''''1672-06-09''
: <code><nowiki>{{start-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}}</code> → {{start-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
: <code><nowiki>{{birth-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}}</code> → {{birth-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
: <code><nowiki>{{end-date|</nowiki><span style="color:#705000;">''<nowiki>9 June 1672</nowiki>'''''|'''''<nowiki>{{OldStyleDate|9 June|1672|30 May}}</nowiki>''</span>}} </code> → {{end-date|9 June 1672|{{OldStyleDate|9 June|1672|30 May}}}}
|}
=== Microformat output ===
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{Start-date|31 December 2016}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{Birth-date|31 December 2016}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{End-date|31 December 2016}}</nowiki>}}
== Parameters ==
;''parameter 1'': (required) The date and time to display and to emit as a microformat date. If year is absent, the current year is assumed. If day is missing, the first of the month is assumed. If hour, or minutes are missing, zero is assumed. If time zone or location is missing, the local time of the event discussed in the article is assumed. See timezone parameter if [[UTC]] time is desired. Authors may specify place names ([[Template:Start-date/doc/timezones|see list]]) or time zones such as EDT, PST, HST and so on and these will be properly adjusted to [[UTC| UTC (Coordinated Universal Time)]] for transfer to other applications via microformat encoding. Gregorian calendar dates are required. Display in Julian or Chinese calendar date is possible using parameter 2.
<!--;''parameter 2'' (optional): If present, this wikitext is displayed rather than the date in parameter 1. These might be links to day of month or year pages. EG. December 7, 1941
commenting out deprecated practice -->
;ISO8601: (optional) if present, this ISO8601 date/time value is emitted instead of the value derived from parameter 1.
;BCE: (required for BCE dates) set to yes if the date is BC.
;timezone
;tz: (required if timezone information specified) Set to yes if the time is [[UTC]] or if the location, timezone, or timezone offset is specified.
==TemplateData==
{{TemplateDataHeader}}
<templatedata>
{
"params": {
"1": {},
"2": {},
"ISO8601": {},
"dt": {},
"display": {},
"timezone": {},
"tz": {
"description": "set to \"yes\" when timezone is present, or when timzone UTC is implicit",
"type": "boolean"
},
"BCE": {},
"BC": {},
"class-extra": {},
"df": {}
},
"paramOrder": [
"1",
"2",
"ISO8601",
"dt",
"tz",
"timezone",
"BCE",
"BC",
"display",
"class-extra",
"df"
]
}
</templatedata>
== Ambiguous times and dates ==
For the years 99 BC to 99AD especially, microformats may not be emitted properly unless expressed in the form YYYY-MM-DD. For users uninterested in microformats, it should be noted that this restriction has no known impacts other than microformat data which are currently invisible to users. The user of course may express the display form in the second parameter however they would like. Example: 1-2-3 is interpreted as February 3, 1 A.D, and emitted in that form via microformats when the user may have intended something else. Other 3 digit years may be misinterpreted as well, so best practice is to use leading zeros to make a 4 digit year for this date range. For example, February 274 will be interpreted as February 27, 2004. Instead, use "February 0274". Background: There is a good rationale for the behavior of the system function which actually does the hard work of this template. It is very unusual for people to mention such dates so long ago, so when we really mean this date, we must specify a 4 digit date. Outside of this period with ambiguous years, users may use free text dates without this restriction. Bot runs may make a conversion of non 4 digit years to 4 digits (with leading zeros) in order to refine Wikipedia's quality of microformat dates. These changes will not affect display, but for those curious, this is the rationale for such bot manipulations.
== Time zones ==
Most time zone abbreviations as well as a large number of place names are recognized. (See [[Template:Start-date/doc/timezones|recognized timezone values table]].)
:<code><nowiki>{{start-date|December 7, 1941 8:43AM Pacific/Honolulu }}</nowiki></code> → '''{{start-date|December 7, 1941 8:43AM Pacific/Honolulu }}'''
:<code><nowiki>{{start-date|December 8, 1941 12:30PM Asia/Manila }}</nowiki></code> → '''{{start-date|December 8, 1941 12:30PM Asia/Manila }}'''
== See also ==
{{Birth, death and age templates |dates}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Date mathematics templates]]
[[Category:Templates generating microformat dates]]
[[Category:Templates generating hCalendars|{{subst:PAGENAME}}]]
}}</includeonly>