此頁面為 模块: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(東漢建立)