模板:模糊时间/doc

简介

模糊时间模板用于对于任意的一个时间描述文本进行格式化。

参数

括号内为其他名字。

• 第一个参数（text、时间文本）：任意描述时间的文本。
• 第二个参数（pattern、格式化字符串）：指示格式化的结果，如果文本描述中缺乏对应信息，会被忽略。
• 第三个参数（ignore、强制精确度）：设置为true指示忽略非必要粗略描述格式，设置为false指示强制输出所有格式化结果。默认为nil，正常进行格式化。
• 第四个参数（o_tz 、o_timezone 、原时区）：设置原时区，即文本使用时区，格式为XX:XX。留空则不进行时区转换。
• 第五个参数（c_tz、c_timezone、现时区）：现时区，即显示时区。默认采用{{timezone}}模板定义的时区。可以参考该模板的介绍。
• 第六个参数（a_pattern、analysis_pattern、分析字符串）：指定该字符串将特定匹配方式，只匹配固定格式的时间文本。
• from（原语言）：目前可选zh（中文）或en（英文）或all（全部）。根据不同的选择识别方式有所不同。默认为zh。
• to（目标语言）：目前可选zh（中文）或en（英文）。根据不同的选择格式化方式有所不同。默认为zh。

其中格式化patternanalysis_pattern的占位符标准详见#占位符。

简单实例

{{模糊时间|2033年1月4日|%E}} 2033-01-04

占位符

格式化使用到作为时间段描述方式（或许可以考虑增加到占位符中）。 格式化使用的替换用占位符如下。 待扩展中文数字表达。

示例时间：2024年10月21日11时1分34秒

类型	格式化参数	说明	输出
	%E	日期-年月日 （ISO 8601格式）（不支持省略）	2024-10-21
	%(Eo)	日期-年月日 （ISO 8601格式）（不支持省略）	2024.10.21
	%(Ew)	日期-年周星期 （ISO 8601格式）（不支持省略）	2024-W43-1
	%e	时间-时分秒 （ISO 8601格式）（不支持省略）	11:01:34
	%a	根据时间是上午还是下午，输出am或pm	am
	%(au)	根据时间是上午还是下午，输出AM或PM	AM
	%(cf)	日期-世纪，2位数字，补足前导0	21
	%(tf)	日期-年代，2位数字，补足前导0	20
	%(yf)	日期-年份，4位数字，补足前导0	2024
	%(mf)	日期-月，2位数字，补足前导0	10
	%(df)	日期-日，2位数字，补足前导0	21
	%(wf)	日期-年内第几周，2位数字，补足前导0	43
	%(hf)	时间-小时，2位数字，补足前导0	11
	%(if)	时间-分钟，2位数字，补足前导0	01
	%(sf)	时间-秒，2位数字，补足前导0	34
	%c	日期-世纪	21
	%t	日期-年代	2020
	%y	日期-年份	2024
	%m	日期-月	10
	%w	日期-年内第几周	43
	%d	日期-日	21
	%(dy)	日期-日 年内第几日	295
	%l	日期-星期，1位数字	1
	%h	时间-小时	11
	%(hy)	时间-小时 十二小时制	11
	%i	时间-分钟	1
	%s	时间-秒	34
	%X	年月日时分秒 （ISO 8601格式）（不支持省略）	2024-10-21 T11:01:34
	%x	年周日时分秒 （ISO 8601格式）（不支持省略）	2024W43-21 T11:01:34
en	%T		2020s
	%(Ms)		Oct
	%M		October
	%(Ls)		Mon
	%L		Monday
	%D		21nd
zh	%C	日期-世纪 单位“世纪”	21世纪
	%(Tf)	日期-年代 单位“年代”，只取后两位	20年代
	%T	日期-年代 单位“年代”	2020年代
	%Y	日期-年 单位“年”	2024年
	%M	日期-月 单位“月”	10月
	%(Mc)	日期-月 中文文字	十月
	%W	日期-周 单位“周”	43周
	%D	日期-日 单位“日”	21日
	%(Dy)	日期-日 年内第几日 单位“日”	295日
	%(Do)	日期-日 单位“号”	21号
	%L	日期-星期 中文文字“星期”	星期一
	%(Lss)	日期-星期 中文文字大写“周”	周一
	%(Ls)	日期-星期 只输出一个中文文字	一
	%H	时间-时 单位“时”	11时
	%(Hy)	时间-时 单位“时” 十二小时制	11时
	%(Ho)	时间-时 单位“点”	11点
	%I	时间-分 单位“分”	1分
	%S	时间-秒 单位“秒”	34秒
	%(Mi)	日期-月内描述“旬”，十日为一旬	下旬
	%A	时间-根据时间输出上午或下午	上午
	%(Di)	时间-日内详细描述	中午