用户:CrablePotion/模板/TimeFilter

文档  

这个文档是内联文档。

这个模板用于判断现在的时间是否与规则匹配，如果匹配则返回指定内容。

用法

该模板有三种匹配方式：

1. 匹配确切时间，即参数范围=0（默认），且年、月、日任意一个不为空。如果月=3，则会匹配3月的每一天；如果月=3|日=1，则会匹配每年的3月1日。
2. 匹配特定范围内的时间，即参数范围=1，且始、末任意一个不为空。需要注意的是，无论是始还是末，输入的都需要是unix时间戳。如果始=946656000（对应时间2000-01-01 00:00:00），则会匹配自2000-01-01 00:00:00之后的时间；如果始=946656000且末=1704038400（2024-01-01 00:00:00），则会匹配从2000-01-01 00:00:00开始，到2024-01-01 00:00:00结束的时间。参数始和末必须使得始<=末。
3. 混合模式，即参数范围=2，且同时满足1与2的条件：年、月、日任意一个不为空，始、末任意一个不为空。如果始=946656000，末=1704038400，月=3，则会匹配从2000年至2024年中每个3月的每一天。

举例： {{用户:CrablePotion/模板/TimeFilter|UTC=0|范围=0|年=2024|返回=true}} 在2024年（世界协调时）时会返回true，反之不返回。
效果如下：true（没有返回就说明现在不是2024年）

判断当前时间是否与规则匹配

模板参数

参数		描述	类型	状态
时区	UTC	当前时区的UTC值 默认值 8 (北京时间)	字符串	可选
年	年	匹配的年份	字符串	可选
月	月	匹配的月份	字符串	可选
日	日	匹配的日期	字符串	可选
开始的时间点	始	开始的unix时间戳	字符串	可选
末尾的时间点	末	末尾的unix时间戳	字符串	可选
逻辑非	非	在不满足时返回	字符串	可选
是否启用范围	范围	0-不启用；1-仅范围；2-混合 默认值 0 (不启用)	字符串	可选
返回内容	返回	判断为真时返回的内容，可作为wikitext解析	字符串	必需