模組:Date Convert/doc

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

Pún pang-bô͘ hông sú-iōng tī approximately 5,200 ia̍h téng-bīn, só͘-í i-ê kái-piàn ē siū tio̍h tōa hoān-ûi ê chù-ì. Chhiáⁿ tī kài-piàn chìn-chêng seng tī pâng-bô͘ ê /sandbox ia̍h /testcases chhù-ia̍h-bīn chhì-giām, he̍k-chiá sī tī lí ka-tī ê iōng-chiá chhù-ia̍h-bīn. Chhiáⁿ tī si̍t-hêng kái-piàn chìn-cheng khó-lū seng tī thó͘-lūn-ia̍h chham-siông chi̍t--leh.

本模块用于将各类日期转换为ISO 8601格式或中文日期，以方便{{#time:params}}函数和其他模板调用。

用法 siu-kái

输出ISO日期 siu-kái

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

输入完整日期，只输入年月、只输入年份皆可：

{{#invoke:Date_Convert|ISODate|1994 nî 10 goe̍h 26 ji̍t}} → 1994-10
{{#invoke:Date_Convert|ISODate|1994 nî 10 goe̍h}} → 1994
{{#invoke:Date_Convert|ISODate|1994 nî}} → 1994

当月和日是个位数时，十位加“0”或不加“0”皆可，模块会自动补“0”，

{{#invoke:Date_Convert|ISODate|1994 nî 8 goe̍h 1 ji̍t}} → 1994
{{#invoke:Date_Convert|ISODate|1994 nî 08 goe̍h 01 ji̍t}} → 1994

可以转换英文和非规范的ISO 8601日期：

{{#invoke:Date_Convert|ISODate|October 26, 1994}} → 1994-10-26
{{#invoke:Date_Convert|ISODate|26 Oct 1994}} → 1994-10-26
{{#invoke:Date_Convert|ISODate|Sept 1994}} → 1994-09
{{#invoke:Date_Convert|ISODate|1994-8-1}} → 1994-08-01
{{#invoke:Date_Convert|ISODate|1994-8}} → 1994-08

如果字符串以正确的日期开头，则会转换并忽视后缀文字：

{{#invoke:Date_Convert|ISODate|1994年10月26日，武汉}} → 1994
{{#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日}} → 1994
{{#invoke:Date_Convert|ISODate|一九九四年十月二十六日|error=ignore}} → 一九九四年十月二十六日（将error字段设为ignore返回输入值）

ISO 8601标准只规定了1583年之后的日期标准，请勿用本模块表示这之前的日期，否则可能会得到不期待的结果：

{{#invoke:Date_Convert|ISODate|25年8月5日（东汉建立）|suffix=yes}} → 错误：时间格式不正确

而{{#invoke:ISODate|dates|xxx}}等效於此{{#invoke:Date_Convert|ISODate|xxx}}。

输出中文日期 siu-kái

使用{{#invoke:Date_Convert|ChineseDate}}函数。