编辑“︁Template:Start date/doc”︁

{{Documentation subpage}}
{{High-use}}
{{COinS safe|n}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

模板'''{{tl|Start date}}'''及'''{{tl|End date}}'''會傳回一個日期值，又或日期與時間的值。這個值傳回的同時，還附帶一個隱藏的ISO日期格式（以CSS實現），以供[[微格式]]使用。當用戶端不能使用CSS時，這個隱藏的日期會自動降格。

===何時不應使用這一模板？===
請勿將此模板用於以下用途：
* 不確定的日期，例如「1933年4月4日前」、「大約1939年11月18日」。
* 不在[[模板:Start date/doc|限制]]範圍內的日期。
* 其他或次要的日期。
* 不在[[微格式]]發出模板內的日期——若有疑問，請參閱上層模板文件。
* 在任何上層模板中多於一個日期。

===用法===
* {{tlx|start date|year|month|day}}
* {{tlx|start date|year|month|day|HH|MM|SS|TimeZone}} (MM and SS are optional; TimeZone may be a numerical value, or "Z" for [[Coordinated Universal Time|UTC]]; see examples)

; 例子：
* {{tlx|start date|1993}} → "{{start date|1993}}"
* {{tlx|start date|1993|02}} → "{{start date|1993|02}}"
* {{tlx|start date|1993|02|24}} → "{{start date|1993|02|24}}"
* {{tlx|start date|1993|02|24|08|30}} → "{{start date|1993|02|24|08|30}}"
* {{tlx|start date|1993|02|24|08<nowiki>|||+01:00</nowiki>}} → "{{start date|1993|02|24|08|||+01:00}}"
* {{tlx|start date|1993|02|24|08<nowiki>|||-07:00</nowiki>}} → "{{start date|1993|02|24|08|||-07:00}}"
* {{tlx|start date|1993|02|24|08|30|23}} → "{{start date|1993|02|24|08|30|23}}"
* {{tlx|start date|1993|02|24|08|30|23|Z}} → "{{start date|1993|02|24|08|30|23|Z}}"
* {{tlx|start date|1993|02|24|08|30|23|+01:00}} → "{{start date|1993|02|24|08|30|23|+01:00}}"
* {{tlx|start date|1993|02|24|08|30|23|-07:00}} → "{{start date|1993|02|24|08|30|23|-07:00}}"

原來的英文版有 ''df'' 選項，當這選項被設定時，會強制日期以歐洲式（即 日/月/年 ，而非北美式的 月/日/年）顯示。'''這個選項在中文版無效。'''例如：
*<nowiki>{{Start date|1993|02|24|08|30|df=yes}}</nowiki> 仍然顯示為 年/月/日： "{{Start date|1993|02|24|08|30|df=yes}}"

'''注意：'''

如果year参数留空的话，即使後面有填入month、day參數也不會顯示：
*<nowiki>{{Start date|  |02|24}}</nowiki> 返回 "{{Start date|  |02|24}}"（空白）

如果有year、day參數無month參數，只顯示年份，其它情況如此類推：
*<nowiki>{{Start date|1993|  |24}}</nowiki> 返回 "{{Start date|1993|  |24}}"

===參數===
{{TemplateDataHeader}}
<templatedata>{
"description": "Date that an event or entity started or was created",
"params": {
"1": {"label": "YYYY", "description": "開始的年份", "type": "number"},
"2": {"label": "MM", "description": "開始的月份", "inherits": "1"},
"3": {"label": "DD", "description": "開始的日期", "inherits": "1"},
"4": {"label": "HH", "description": "開始的小時數", "inherits": "1"},
"5": {"label": "MM", "description": "開始的分鐘數", "inherits": "1", "default": "0"},
"6": {"label": "SS", "description": "開始的秒鐘數", "inherits": "5"},
"7": {"label": "TZ", "description": "時區位移，「+02:00」、「-06:00」或用「Z」表示UTC", "inherits": "1", "type": "string/line"},
"df": {"label": "day first", "description": "Boolean參數，用以將日期置於月份前", "default": "false", "type": "string/line"}
}}</templatedata>

==使用[[微格式]]==
<!-- {{UF-date-part}} -->
中文维基暂无该微格式模板。

详情请看 [[WP:UF|微格式专题]]。

==參看==
* {{tlg|Film date}}，电影上映日期，用于模板{{tl|Infobox film}}
*{{tl|Vgr}}，电子游戏发行日期
*{{tl|End date}}
*{{tl|Start date and age}}
*{{tl|Start-date}}（和此模板功能類似）

{{出生、逝世及日期模板|selected=dates}}
{{Organization infoboxes|state=collapsed}}
<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 -->
[[Category:日期计算模板]]
[[Category:使用hCard的模板]]
<!-- [[Category:Templates generating hAtom]] -->
<!-- [[Category:Templates generating hCalendars]] -->
}}</includeonly>