模組:ISODate/doc檢視原始碼檢視歷史
此頁面為 模块:ISODate 的說明文件
 | 此Luazh-cn:模块; zh-tw:模組;在3,000個頁面+中使用，修改會造成廣泛的影響。請先在zh-cn:模块; zh-tw:模組;的/sandbox或者/testcases子頁面測試。修改前請考慮至討論頁討論變更。 |
本模塊用於將各類日期轉換為ISO 8601格式，以方便{{#time}}函數和其他模板調用。
用法
輸入完整日期，只輸入年月、只輸入年份皆可：
{{#invoke:ISODate|dates|1994年10月26日}}→ 1994-10-26{{#invoke:ISODate|dates|1994年10月}}→ 1994-10{{#invoke:ISODate|dates|1994年}}→ 1994
當月和日是個位數時，十位加「0」或不加「0」皆可，模塊會自動補「0」，
{{#invoke:ISODate|dates|1994年8月1日}}→ 1994-08-01{{#invoke:ISODate|dates|1994年08月01日}}→ 1994-08-01
可以轉換英文和不規範的ISO 8601日期：
{{#invoke:ISODate|dates|October 26, 1994}}→ 1994-10-26{{#invoke:ISODate|dates|26 Oct 1994}}→ 1994-10-26{{#invoke:ISODate|dates|Sept 1994}}→ 1994-09{{#invoke:ISODate|dates|1994-8-1}}→ 1994-08-01{{#invoke:ISODate|dates|1994-8}}→ 1994-08
如果字符串以正確的日期開頭，則會轉換並忽視後綴文字：
{{#invoke:ISODate|dates|1994年10月26日，武汉}}→ 1994-10-26{{#invoke:ISODate|dates|1994年10月26日，武汉|suffix=yes}}→ 1994-10-26，武漢（將suffix字段設為yes展示後綴）
以不合法日期開頭則報錯：
{{#invoke:ISODate|dates|一九九四年十月二十六日}}→ 錯誤：無效時間。{{#invoke:ISODate|dates|1994年13月32日}}→ 錯誤：無效時間。{{#invoke:ISODate|dates|一九九四年十月二十六日|error=ignore}}→ 一九九四年十月二十六日（將error字段設為ignore返回輸入值）
ISO 8601標準只規定了1583年之後的日期標準，請勿用本模塊表示這之前的日期，否則可能會得到不期待的結果：
{{#invoke:ISODate|dates|25年8月5日（东汉建立）|suffix=yes}}→ 0023-08-05（東漢建立）