模组:Date Convert/doc
这是Module:Date Convert的文档页面
 | 此模块文档被引用于约27,000个页面。 为了避免造成大规模的影响，所有对此模块文档的编辑应先于沙盒或测试样例上测试。 测试后无误的版本可以一次性地加入此模块文档中，但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
本模块用于将各类日期转换为ISO 8601格式或中文日期，以方便{{#time:params}}函数和其他模板调用。
用法
[编辑]输出ISO日期
[编辑]使用{{#invoke:Date_Convert|ISODate}}函数。
输入完整日期，只输入年月、只输入年份皆可：
{{#invoke:Date_Convert|ISODate|1994年10月26日}}→ 1994-10-26{{#invoke:Date_Convert|ISODate|1994年10月}}→ 1994-10{{#invoke:Date_Convert|ISODate|1994年}}→ 1994
当月和日是个位数时，十位加“0”或不加“0”皆可，模块会自动补“0”，
{{#invoke:Date_Convert|ISODate|1994年8月1日}}→ 1994-08-01{{#invoke:Date_Convert|ISODate|1994年08月01日}}→ 1994-08-01
可以转换英文和非规范的ISO 8601日期：
{{#invoke:Date_Convert|ISODate|October 26, 1994}}→ 1994-10-26{{#invoke:Date_Convert|ISODate|26 Oct 1994}}→ 1994-10-26{{#invoke:Date_Convert|ISODate|Sept 1994}}→ 1994-09{{#invoke:Date_Convert|ISODate|1994-8-1}}→ 1994-08-01{{#invoke:Date_Convert|ISODate|1994-8}}→ 1994-08
如果字符串以正确的日期开头，则会转换并忽视后缀文字：
{{#invoke:Date_Convert|ISODate|1994年10月26日，武汉}}→ 1994-10-26{{#invoke:Date_Convert|ISODate|1994年10月26日，武汉|suffix=yes}}→ 1994-10-26，武汉（将suffix字段设为yes展示后缀）
以不合法日期开头则报错：
{{#invoke:Date_Convert|ISODate|一九九四年十月二十六日}}→ 错误：时间格式不正确{{#invoke:Date_Convert|ISODate|1994年13月32日}}→ 错误：时间格式不正确{{#invoke:Date_Convert|ISODate|一九九四年十月二十六日|error=ignore}}→ 一九九四年十月二十六日（将error字段设为ignore返回输入值）
ISO 8601标准只规定了1583年之后的日期标准，请勿用本模块表示这之前的日期，否则可能会得到不期待的结果：
{{#invoke:Date_Convert|ISODate|25年8月5日（东汉建立）|suffix=yes}}→ 0023-08-05（东汉建立）
而{{#invoke:ISODate|dates|xxx}}等效于此{{#invoke:Date_Convert|ISODate|xxx}}。
输出中文日期
[编辑]使用{{#invoke:Date_Convert|ChineseDate}}函数。
输入完整日期，只输入年月、只输入年份皆可：
{{#invoke:Date_Convert|ChineseDate|1994年10月26日}}→ 1994年10月26日{{#invoke:Date_Convert|ChineseDate|1994年10月}}→ 1994年10月{{#invoke:Date_Convert|ChineseDate|1994年}}→ 1994年
当月和日是个位数时，十位加“0”或不加“0”皆可，模块会自动补“0”，
{{#invoke:Date_Convert|ChineseDate|1994年8月1日}}→ 1994年8月1日{{#invoke:Date_Convert|ChineseDate|1994年08月01日}}→ 1994年8月1日
可以转换英文和非规范的ISO 8601日期：
{{#invoke:Date_Convert|ChineseDate|October 26, 1994}}→ 1994年10月26日{{#invoke:Date_Convert|ChineseDate|26 Oct 1994}}→ 1994年10月26日{{#invoke:Date_Convert|ChineseDate|Sept 1994}}→ 1994年9月{{#invoke:Date_Convert|ChineseDate|1994-8-1}}→ 1994年8月1日{{#invoke:Date_Convert|ChineseDate|1994-8}}→ 1994年8月
如果字符串以正确的日期开头，则会转换并忽视后缀文字：
{{#invoke:Date_Convert|ChineseDate|1994年10月26日，武汉}}→ 1994-10-26
以不合法日期开头则报错：
{{#invoke:Date_Convert|ChineseDate|一九九四年十月二十六日}}→ 错误：时间格式不正确{{#invoke:Date_Convert|ChineseDate|1994年13月32日}}→ 错误：时间格式不正确{{#invoke:Date_Convert|ChineseDate|一九九四年十月二十六日|error=ignore}}→ 一九九四年十月二十六日（将error字段设为ignore返回输入值）
ISO 8601标准只规定了1583年之后的日期标准，请勿用本模块表示这之前的日期，否则可能会得到不期待的结果：
{{#invoke:Date_Convert|ChineseDate|25年8月5日（东汉建立）}}→ 23年8月5日
而{{#invoke:Date_Convert|ChineseDate|xxx}}等效于此{{#invoke:Chinese_date|main|xxx}}。