求真百科歡迎當事人提供第一手真實資料,洗刷冤屈,終結網路霸凌。

變更

前往: 導覽搜尋

模块:ISODate/doc

增加 2,554 位元組, 7 年前
無編輯摘要
{{NoteTA
|1=zh-cn:模块; zh-tw:模組;
}}
{{high-use|3,000+}}
本模块用于将各类日期转换为[[ISO 8601]]格式,以方便{{tlc|#time}}函数和其他模板调用。

== 用法 ==

输入完整日期,只输入年月、只输入年份皆可:
* {{tlc|#invoke:ISODate|dates|1994年10月26日}} → {{#invoke:ISODate|dates|1994年10月26日}}
* {{tlc|#invoke:ISODate|dates|1994年10月}} → {{#invoke:ISODate|dates|1994年10月}}
* {{tlc|#invoke:ISODate|dates|1994年}} → {{#invoke:ISODate|dates|1994年}}

当月和日是个位数时,十位加“0”或不加“0”皆可,模块会自动补“0”,
* {{tlc|#invoke:ISODate|dates|1994年8月1日}} → {{#invoke:ISODate|dates|1994年8月1日}}
* {{tlc|#invoke:ISODate|dates|1994年08月01日}} → {{#invoke:ISODate|dates|1994年08月01日}}

可以转换英文和不规范的ISO 8601日期:
* {{tlc|#invoke:ISODate|dates|October 26, 1994}} → {{#invoke:ISODate|dates|October 26, 1994}}
* {{tlc|#invoke:ISODate|dates|26 Oct 1994}} → {{#invoke:ISODate|dates|26 Oct 1994}}
* {{tlc|#invoke:ISODate|dates|Sept 1994}} → {{#invoke:ISODate|dates|Sept 1994}}
* {{tlc|#invoke:ISODate|dates|1994-8-1}} → {{#invoke:ISODate|dates|1994-8-1}}
* {{tlc|#invoke:ISODate|dates|1994-8}} → {{#invoke:ISODate|dates|1994-8}}

如果字符串以正确的日期开头,则会转换并忽视后缀文字:
* {{tlc|#invoke:ISODate|dates|1994年10月26日,武汉}} → {{#invoke:ISODate|dates|1994年10月26日,武汉}}
* {{tlc|&#35;invoke:ISODate|dates|1994年10月26日,武汉|suffix&#61;yes}} → {{#invoke:ISODate|dates|1994年10月26日,武汉|suffix=yes}}(将<code>suffix</code>字段设为<code>yes</code>展示后缀)

以不合法日期开头则报错:
* {{tlc|&#35;invoke:ISODate|dates|一九九四年十月二十六日}} → {{#invoke:ISODate|dates|一九九四年十月二十六日}}
* {{tlc|&#35;invoke:ISODate|dates|1994年13月32日}} → {{#invoke:ISODate|dates|1994年13月32日}}
* {{tlc|&#35;invoke:ISODate|dates|一九九四年十月二十六日|error&#61;ignore}} → {{#invoke:ISODate|dates|一九九四年十月二十六日|error=ignore}}(将<code>error</code>字段设为<code>ignore</code>返回输入值)

ISO 8601标准只规定了1583年之后的日期标准,请勿用本模块表示这之前的日期,否则可能会得到不期待的结果:
* {{tlc|&#35;invoke:ISODate|dates|25年8月5日(东汉建立)|suffix&#61;yes}} → {{#invoke:ISODate|dates|23年8月5日(东汉建立)|suffix=yes}}