開啟主選單

求真百科

此頁面為 模块:ISODate 的說明文件

本模塊用於將各類日期轉換為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(東漢建立)