模組: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}}。