模板:Start-date/doc
 | 此頁面是Template:Start-date的模板文件。 此頁面可能包含了模板的使用說明、分類和其他內容。 |
 | 本模板含有複雜而精密的擴展語法。 編輯本模板前，建議您先熟悉解析器函數與本模板的設計思路、運作原理等。若您的編輯引發了意外的問題，請儘快撤銷編輯，因為本模板可能被大量頁面使用。 您所作的編輯可先在模板沙盒或您的個人頁面中進行測試。 |
{{Start-date}}、{{Birth-date}}和{{End-date}}（也可使用{{Death-date}}）是易於閱讀的「純文本」日期和時間模板，可為事件生成微格式日期。{{Start date}}/{{Birth date}}和{{End date}}/{{Death date}}模板也可生成微格式，但要求日期以標準、明確和國際化的ISO語法表達。而本模板支持「模糊」日期和時間。對於不知道確切時間、日期或月份的事件，用戶可以省略這些細節。時區假定為事件所在地的時區。如果指定了時區信息，則必須設置可選的時區參數。
示例
下面的示例顯示1941年12月7日，並生成隱藏的微格式日期：1941-12-07
|
下面的示例顯示1941年12月7日，並生成隱藏的微格式日期：1941-12-07
|
下面的示例演示了如何顯示日期、時區和時、分、秒（順序通常並不重要）。顯示5:43PM HST, December 7th, 1941 03:43，並生成隱藏的微格式日期（修正為UTC）：1941-12-08T03:43Z
|
下面的示例演示了通過提供當地位置來生成UTC值。顯示1941年12月8日 03:20，並生成隱藏的微格式日期（修正為UTC）：1941-12-08 T03:20Z
|
下面的示例演示了儒略曆日期的使用。顯示1672年6月9日，並生成隱藏的微格式日期：1672-06-09
|
微格式輸出
Start date模板：
{{Start-date|31 December 2016}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="dtstart ">2016-12-31</span>)</span>
{{Start date|2016|12|31|df=y}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="bday dtstart published updated">2016-12-31</span>)</span>
Birth date模板：
{{Birth-date|31 December 2016}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="dtstart bday">2016-12-31</span>)</span>
{{Birth date|2016|12|31|df=y}}→ 2016年12月31日<span style="display:none">(<span class="bday">2016-12-31</span>)</span>2016年12月31日
End date模板：
{{End-date|31 December 2016}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="dtend ">2017-01-01</span>)</span>
{{End date|2016|12|31|df=y}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="dtend">2016-12-31</span>)</span>
Death date模板：
{{Death-date|31 December 2016}}→ 2016年12月31日2016年12月31日<span style="display:none"> (<span class="dtend ">2017-01-01</span>)</span>
{{Death date|2016|12|31|df=y}}→ 2016年12月31日2016年12月31日<span style="display:none">（<span class="dday deathdate">2016-12-31</span>）</span>
參數
- 匿名參數1
- （必填）日期和時間，用於顯示和輸出微格式。如果沒有年份，則假定為當前年份。如果缺少日，則假定為每月1日。如果缺少小時或分鐘，則假定為零。如果缺少時區或地點，則假定為條目中討論事件的當地時間。如果需要UTC時間，請參閱timezone參數的說明。編者可指定地名（見列表）或時區，如EDT、PST、HST等，這些時區將被適當調整為UTC（協調世界時），以便通過微格式編碼傳送到其他應用程式。需要公曆日期。使用匿名參數2可以顯示公曆或農曆日期。
- ISO8601
- （可選）填寫後則將發送該ISO8601日期/時間值，而不是匿名參數1得出的值。
- BCE
- （公元前日期必填），如果日期為公元前，則設置為yes。
- timezone
- tz
- （如果指定了時區信息，則必填）如果時間為UTC或者指定了位置、時區或時區偏移量，則設置為yes。
模板數據
沒有描述。
| 參數 | 描述 | 類型 | 狀態 | |
|---|---|---|---|---|
| 1 | 1 | 沒有描述 | 不明 | 非必填 |
| 2 | 2 | 沒有描述 | 不明 | 非必填 |
| ISO8601 | ISO8601 | 沒有描述 | 不明 | 非必填 |
| dt | dt | 沒有描述 | 不明 | 非必填 |
| tz | tz | set to "yes" when timezone is present, or when timzone UTC is implicit | 布林值 | 非必填 |
| timezone | timezone | 沒有描述 | 不明 | 非必填 |
| BCE | BCE | 沒有描述 | 不明 | 非必填 |
| BC | BC | 沒有描述 | 不明 | 非必填 |
| display | display | 沒有描述 | 不明 | 非必填 |
| class-extra | class-extra | 沒有描述 | 不明 | 非必填 |
| df | df | 沒有描述 | 不明 | 非必填 |
模糊的時間和日期
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.
時區
可識別大多數時區縮寫和大量地名。（請參見可識別的時區表）。
{{start-date|December 7, 1941 8:43AM Pacific/Honolulu }}→ 1941年12月7日 19:13{{start-date|December 8, 1941 12:30PM Asia/Manila }}→ 1941年12月8日 04:30
參見
- {{Date-mf}}