跳转到内容

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

参见

[编辑]