帮助:语法/模板

提示：此页面“帮助:语法/模板”正在被其他人编辑中 我们十分不推荐您现在立刻编辑这个页面！这会导致 编辑冲突，您和其他编辑者可能失去编辑数据； 这条信息是 僵尸君呀[更多]讨论页贡献上传历史封禁用户被删贡献移动日志巡查日志评论管理日志用户权限及日志所有评论用户查核留下的； 如果您有任何改进意见，请发布在 其用户讨论页； 从2023/2/21 19:31开始计算，用户 僵尸君呀 预计用 持续可能很久的时间 完成此次编辑； 您可在 本页面的页面历史 中查看过往编辑版本。

关于模板调用语法，见此。

参数与赋值

描述	模板键入	输出效果	调用页面键入
无参数	欢迎来到Utcwiki！	{{模板名}}	欢迎来到Utcwiki！
匿名参数（不赋值）	欢迎来到{{{1}}}！全称是{{{2}}}。	{{模板名}}	欢迎来到{{{1}}}！全称是{{{2}}}。
匿名参数（隐式赋值）		{{模板名|一}}	欢迎来到一！全称是二。
匿名参数（按序号赋值）		{{模板名|1=一|2=二}}	欢迎来到一！全称是二。
		{{模板名|2=二|1=一}}	欢迎来到一！全称是二。
命名参数（不赋值）	欢迎来到{{{名称}}}！全称是{{{全称}}}。	{{模板名}}	欢迎来到{{{名称}}}！全称是{{{全称}}}。
命名参数（按名称赋值）		{{模板名|名称=一|全称=二}}	欢迎来到一！全称是二。
匿命名参数混用（不赋值）	欢迎来到{{{1}}}！全称是{{{全称}}}。	{{模板名}}	欢迎来到{{{1}}}！全称是{{{全称}}}。
匿命名参数混用		{{模板名|一|全称=二}}	欢迎来到一！全称是二。
		{{模板名|1=一|全称=二}}	欢迎来到一！全称是二。
	欢迎来到{{{名称}}}！全称是{{{1}}}。	{{模板名|名称=一|二}}	欢迎来到一！全称是二。
		{{模板名|二|名称=一}}	欢迎来到一！全称是二。
	欢迎来到{{{名称}}}！全称是{{{2}}}。	{{模板名|名称=一|二}}	欢迎来到一！全称是{{{2}}}。
		{{模板名|二|名称=一}}	欢迎来到一！全称是{{{2}}}。
		{{模板名|名称=一|1=二}}	欢迎来到一！全称是{{{2}}}。
		{{模板名|名称=一|2=二}}	欢迎来到一！全称是二。
		{{模板名|名称=一|三|二}}	欢迎来到一！全称是二。
		{{模板名|名称=一|2=三|二}}	欢迎来到一！全称是三。

(常用于模板的)解析器函数

描述			模板键入	输出效果
#expr 计算数学表达式并返回计算值。	运算	一般运算 可用：+-*/、abs、exp、ln、sin、cos、tan、acos、asin、atan等	{{#expr: 1+1 }} {{#expr: abs -1}} {{#expr: ln 0.5}} {{#expr: exp 2}}	2 1 -0.69314718055995 7.3890560989307
		逻辑运算 使用and或or时，输入端视0为false，其他数字为true。 结果为true时输出1，为false时输出0.	{{#expr: 1 and -1 }} {{#expr: 1 and 0 }} {{#expr: 1 or -1 }} {{#expr: -1 or 0 }} {{#expr: 0 or 0 }}	1 0 1 1 0
			{{#expr:not (1 and -1) }} {{#expr:not (1 and 0) }} {{#expr:not (1 or -1) }} {{#expr:not (-1 or 0) }} {{#expr:not (0 or 0) }}	0 1 0 0 1
			{{#expr:1=0}} {{#expr:1!=0}} {{#expr:1>0>-1}} {{#expr:1>0}} {{#expr:1<0}} {{#expr:1>=0}} {{#expr:1<=0}}	0 1 1 1 0 1 0
	取整	四舍五入 round：将数字向接近“1/10的幂的N倍”的方向四舍五入。 trunc：舍去小数部分。	{{#expr: 1/3 round 5 }} {{#expr: 1/3 round 3 }} {{#expr: 1/6 round 5 }} {{#expr: 1/6 round 3 }} {{#expr:2333 round -2 }} {{#expr:trunc 1.233}}	0.33333 0.333 0.16667 0.167 2300 1
		向上/向下 ceil：向上取整。 floor：向下取整。	{{#expr: ceil 1.4 }} {{#expr: ceil 1.5 }} {{#expr: floor 1.4 }} {{#expr: floor 1.5 }}	2 2 1 1
#if 判断输入内容是否为空。	{{#if:测试字符串| 测试字符串非空时的输出 | 测试字符串为空或仅包含空白字符时的输出(可忽略) }}		{{#if:|yes|no}} {{#if:|yes}} {{#if:str|yes|no}} {{#if:      |yes|no}}	no yes no
#ifeq 判断两个输入内容是否相同。	{{#ifeq: 测试字符串1 | 测试字符串2 | 测试字符串1与测试字符串2相同时的输出 | 测试字符串1与测试字符串2不同时的输出(可忽略) }}	如果两个字符串均为一般的数学运算，则会进行结果数值的比较。	{{#ifeq:1+1|2|yes|no}} {{#ifeq:1e3|1000|yes|no}} {{#ifeq:13|15-2|yes|no}}	no yes no
		否则会进行文本的比较（大小写敏感）。	{{#ifeq:str1|str2|yes|no}} {{#ifeq:str1|str1|yes|no}} {{#ifeq:str1|str2|yes}} {{#ifeq:str1|str1|yes}}	no yes yes
#iferror 判断输入内容是否存在错误。	{{#iferror: 测试字符串|测试字符串存在错误|测试字符串不存在错误(可忽略)}}	测试字符串包含其他解析器函数（比如#expr、#time和#rel2abs）错误、模板错误（比如模板循环和模板递归）或其他解析器“软错误”生成的class="error"的HTML对象，那么视为存在错误。	{{#iferror:{{#expr:1+X}}|yes|no}} {{#iferror:{{#expr:1+2}}|yes|no}} {{#iferror:{{#expr:1+X}}|yes}} {{#iferror:{{#expr:1+2}}|yes}} {{#iferror:{{#expr:1+X}}}} {{#iferror:{{#expr:1+2}}}}	yes no yes 3 3
#ifexpr 将输入内容作为数学表达式解析并根据其对应的布尔值返回对应的字符串。	{{#ifexpr:测试字符串|对应的布尔值为true|对应的布尔值为false(可忽略)}}	等价于{{#ifeq:{{#expr:测试字符串}}|0|对应的布尔值为false|对应的布尔值为true(可忽略)}}	{{#ifexpr:0|yes|no}} {{#ifexpr:2-2|yes|no}} {{#ifexpr:1|yes|no}} {{#ifexpr:2+2|yes|no}} {{#ifexpr:1>0|yes|no}} {{#ifexpr:1<0|yes|no}} {{#ifexpr:1<0|yes|no}}	no no yes yes yes no no
#ifexist 将输入内容作为页面标题解析并根据其对应的布尔值返回对应的字符串。	{{#ifexist:测试字符串|对应的布尔值为true|对应的布尔值为false(可忽略)}}	只要页面存在就会判定为true，即便那个页面看上去是空白的（分类或者是魔术字之类的不包含任何可视内容的页面）。当且仅当页面不存在时判定为false，包括那些曾经存在现在被删除的页面。	{{#ifexist:Undertale|yes|no}} {{#ifexist:特殊:特殊页面|yes|no}} {{#ifexist:分类:AU|yes|no}} {{#ifexist:分类:有脚本错误的页面|yes|no}} {{#ifexist:file:logo.png|yes|no}} {{#ifexist:aaaaa|yes|no}}	yes yes yes no yes no
#rel2abs 将输入内容作为相对路径解析并转换为绝对路径。	{{#rel2abs:相对路径|基本路径(可忽略)}}	“相对路径”输入项中可以使用以下类型的句法： . → 本级路径 .. → 父页面 /foo → 子页面/foo 若“基本路径”输入项没有内容，将默认的填入函数所在页面的绝对路径。	{{#rel2abs:.}} {{#rel2abs:/示例模板1}} {{#rel2abs:..|帮助:语法/模板/示例模板1}}	帮助:语法/模板 帮助:语法/模板/示例模板1 帮助:语法/模板
#switch 将一个输入内容数个测试值作比较，如果找到匹配，则输出相应的结果。	{{#switch:测试字符串|测试值1=结果1|测试值2=结果2|...|默认结果}}	如果测试字符串不能与任何测试值匹配，则输出默认结果	{{#switch:a|a=输入了a|b=输入了b|c=输入了c|输入了其他字符}} {{#switch:b|a=输入了a|b=输入了b|c=输入了c|输入了其他字符}} {{#switch:c|a=输入了a|b=输入了b|c=输入了c|输入了其他字符}} {{#switch:d|a=输入了a|b=输入了b|c=输入了c|输入了其他字符}}	输入了a 输入了b 输入了c 输入了其他字符
	{{#switch:测试字符串|测试值1=结果1|测试值2|测试值3=结果2|测试值4|测试值5|测试值6=结果3|...|默认结果}}	也可以让多个测试值对应相同的结果。	{{#switch:a|a=输入了a|b|c=输入了b或c|输入了其他字符}} {{#switch:b|a=输入了a|b|c=输入了b或c|输入了其他字符}} {{#switch:c|a=输入了a|b|c=输入了b或c|输入了其他字符}} {{#switch:d|a=输入了a|b|c=输入了b或c|d=输入了d|e|f=输入了e或f|输入了其他字符}} {{#switch:e|a=输入了a|b|c=输入了b或c|d=输入了d|e|f=输入了e或f|输入了其他字符}}	输入了a 输入了b或c 输入了b或c 输入了d 输入了e或f
#time 将输入内容作为日期或时间解析并并根据给定的语法将其格式化。	{{#time:格式参数|时间/日期参数（可忽略）|语言代码（可忽略）|时间/日期参数是否使用本地时区（1为使用本地时区，0为使用UTC时区）（可忽略）}}	格式参数 描述 输出 年 Y 年分，4位数 2024 y 年份，2位数 24 o ISO-8601的格式年份 2024 月 n 月份，不填充零 11 m 月份，填充零 11 M 月名的简写，本地语言 11月 F 月名的全称，本地语言 11月 日 j 月内的第几天，不填充零 8 d 月内的第几天，填充零 08 z 年内的第几天（一月一日视为第0天） 312 N 星期几（星期一输出1，星期天输出7） 5 w 星期几（星期日输出0，星期六输出6） 5 D 星期几的简写，本地语言 五 l 星期几的全称，本地语言 星期五 t 本月有多少天 30 周 W 当年第几周，填充零 45 小时 a 上午（00:00:00 → 11:59:59）输出“am”, 下午（12:00:00 → 23:59:59）输出“pm” pm A 上午（00:00:00 → 11:59:59）输出“AM”, 下午（12:00:00 → 23:59:59）输出“PM” PM g 十二小时制的小时数，不填充零 2 h 十二小时制的小时数，填充零 02 G 二十四小时制的小时数，不填充零 14 H 二十四小时制的小时数，填充零 14 分 i 当前小时过去的分钟数，填充零 46 秒 s 当前分钟过去的秒数，填充零 14 U UNIX时间戳 1731077174 时区 e 时区标识符 UTC I 是否使用夏令时，是输出1，否输出0 0 O 与GMT的差值，不带冒号 0000 P 与GMT的差值，带冒号 00:00 T 时区缩写 UTC Z 与GMT的差值，以秒为单位 0 c ISO 8601格式化日期，与Y-m-d"T"H:i:s+00:00等效。 2024-11-08T14:46:14+00:00 r ISO 8601格式化日期，英文版本 Fri, 08 Nov 2024 14:46:14 +0000	{{#time:Y-n-j}} {{#time:Y年n月j日|2014/1/23 10:7:21}} {{#time:c|@1678347919}} {{#time:r|now +2year|1}} {{#time:D|now|en}}	2024-11-8 2014年1月23日 2023-03-09T07:45:19+00:00 Sun, 08 Nov 2026 14:46:14 +0000 Fri
		时间/日期参数可以使用任何PHP strtotime()函数接受的格式。例如绝对时间2022/2/19 2014/1/23 10:7:21、相对时间+20 hours +1 second和混合时间2011/10/9 +10year 若要使用Unix时间戳，需要添加@前缀
		语言代码可以使用任何ISO 639-3标准接受的格式，将输出为对应的语言。
#timel	等价于{{#time: ...|1}}，意味着该函数强制使用本地时区
#titleparts将输入内容解析为页面标题，并根据斜杠划分成多个分段，然后根据参数输出这些分段。	{{#titleparts:页面名称|需要返回的分段数量|要返回的第一个分段（可忽略）}}	如果没有指定要返回的分段数量，则默认为“0”，会从要返回的第一个分段（包含）开始返回所有分段； 如果要返回的第一个分段参数没有设置或者为“0”，则默认为“1”。	{{#titleparts:Foo/bar/baz/quok|2}} {{#titleparts:Foo/bar/baz/quok|2|2}} {{#titleparts:Foo/bar/baz/quok|-2}} {{#titleparts:Foo/bar/baz/quok|-1|-2}}	Foo/bar bar/baz Foo/bar baz