模板: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}}