跳至內容

模組:Date Convert/doc

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書

此頁面為 Module:Date Convert 的說明文件

本模組用於將各類日期轉換為ISO 8601格式或中文日期,以方便{{#time:params}}函數和其他模板調用。

用法

輸出ISO日期

使用{{#invoke:Date_Convert|ISODate}}函數。

輸入完整日期,只輸入年月、只輸入年份皆可:

當月和日是個位數時,十位加「0」或不加「0」皆可,模組會自動補「0」,

可以轉換英文和非規範的ISO 8601日期:

如果字串以正確的日期開頭,則會轉換並忽視後綴文字:

  • {{#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}}函數。

輸入完整日期,只輸入年月、只輸入年份皆可:

當月和日是個位數時,十位加「0」或不加「0」皆可,模組會自動補「0」,

可以轉換英文和非規範的ISO 8601日期:

如果字串以正確的日期開頭,則會轉換並忽視後綴文字:

以不合法日期開頭則報錯:

  • {{#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|xxx}}等效於此{{#invoke:Chinese_date|main|xxx}}

參見