View source for Help:Extension:ParserFunctions/zh

<noinclude>
<languages/>
</noinclude>{{NoteTA|G1=IT|G2=MediaWiki|1=zh-hans:扩展; zh-hant:擴充功能;}}
{{ll|Extension:ParserFunctions|nsp=0}}扩展有提供額外的[[Special:MyLanguage/Parser functions|解析器函数]]以补充MediaWiki中既有的“{{ll|Help:Magic words#Parser functions|魔术字}}”。
（“有可能”会裝配额外針對字符處理的解析器函数；这些字符串函数已记载在{{ll|Extension:ParserFunctions/String functions|其他地方}}之中。）
此扩展所提供的所有解析器函数均采用以下形式：
:<code><nowiki>{{</nowiki>'''#函数名''': ''参数1'' | ''参数2'' | ''参数3''... <nowiki>}}</nowiki></code>

{{PD Help Page}}

== #expr ==
{{for|1=此處並不涵蓋表達式評估器如何運作地更深入(包括一些額外運算符號)的手冊|2=Manual:Expr parser function syntax}}
{| class="wikitable" style="float:{{dir|{{pagelang}}|left|right}}; width:30%; margin-{{dir|{{pagelang}}|right|left}}:1em"
|-
! {{hl1}} | 类型
! {{hl1}} | 运算符号
|-
| {{hl2}} | 分组(括弧)
| style="word-spacing: 0.5em; font-weight: bold;" | <code>( )</code>
|-
| {{hl2}} | 数字
| <code>'''1234.5'''</code> &nbsp; <code>'''e'''</code>&nbsp;(2.718) &nbsp; <code>'''pi'''</code>&nbsp;(3.142)
|-
| {{hl2}} |
| 二元运算符 <code>'''e'''</code> &nbsp; 一元运算符 <code>'''+'''</code>,<code>'''-'''</code>
|-
| {{hl2}} | 一元
| style="word-spacing: 0.5em; font-weight: bold;" | <code>not ceil trunc floor abs exp ln sin cos tan acos asin atan sqrt</code>
|-
| {{hl2}} rowspan="3" | 二元
| style="word-spacing: 0.5em; font-weight: bold;" | <code>^</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>* / div mod fmod</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>+ -</code>
|-
| {{hl2}} | 取整
| style="word-spacing: 0.5em; font-weight: bold;" | <code>round</code>
|-
| {{hl2}} rowspan="3" | 逻辑
| style="word-spacing: 0.5em; font-weight: bold;" | <code>= != <> > < >= <=</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>and</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>or</code>
|}

这个函数计算数学表达式并返回计算值。
可在{{ll|Extension:Scribunto|nsp=0}}中通过<code>mw.ext.ParserFunctions.expr</code>来使用此函数。

:<code><nowiki>{{#expr:</nowiki> ''表达式'' <nowiki>}}</nowiki></code>

Basic example
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 + 1 }}</syntaxhighlight> → '''{{#expr: 1 + 1 }}'''

右表依优先级列出了支持的运算符，每個运算符的详细说明请參见{{ll|Manual:Expr parser function syntax}}。
运算结果的精度和格式受运行wiki服务器操作系统和站点语言的数字格式影响可能存在差异。

使用[[w:zh:逻辑代数|布尔代数]]时，0表示{{phpi|false}}，其他任何非0数值（无论正负）均表示{{phpi|true}}：
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 and -1 }}</syntaxhighlight> → '''{{#expr: 1 and -1 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 and 0 }}</syntaxhighlight> → '''{{#expr: 1 and 0 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 or -1 }}</syntaxhighlight> → '''{{#expr: 1 or -1 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: -1 or 0 }}</syntaxhighlight> → '''{{#expr: -1 or 0 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 0 or 0 }}</syntaxhighlight> → '''{{#expr: 0 or 0 }}'''

空表达式返回空值，无效的表达式返回错误信息，使用<code>[[##iferror|#iferror]]</code>函数检查错误：

:<syntaxhighlight lang="wikitext" inline>{{#expr: }}</syntaxhighlight> → ''' {{#expr: }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1+ }}</syntaxhighlight> → '''{{#expr: 1+ }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 = }}</syntaxhighlight> → '''{{#expr: 1 = }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: 1 foo 2 }}</syntaxhighlight> → '''{{#expr: 1 foo 2 }}'''

置于数字前或数字后的加减号是有意义的，会被视为正负号而不会报错：

:<syntaxhighlight lang="wikitext" inline>{{#expr: +1 }}</syntaxhighlight> → '''{{#expr: +1 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: -1 }}</syntaxhighlight> → '''{{#expr: -1 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: + 1 }}</syntaxhighlight> → '''{{#expr: + 1 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: - 1 }}</syntaxhighlight> → '''{{#expr: - 1 }}'''

注意：如果你使用魔术字的输出数值时，首先要将其格式化以去除逗号，获得纯数字，然後再翻譯該数值。
例如<nowiki>{{NUMBEROFUSERS}}</nowiki>會導致{{NUMBEROFUSERS}}，这里我们想要的是{{formatnum:{{NUMBEROFUSERS}}|R}}，則可以用<code><nowiki>{{</nowiki>{{ll|Help:Magic words#Formatting|formatnum}}<nowiki>:{{NUMBEROFUSERS}}|R}}</nowiki></code>得到。
这在某些数字也會被翻译的语言中尤为重要。
例如，在孟加拉语中，<nowiki>{{NUMBEROFUSERS}}</nowiki>會產出৩০,০৬১。

:<syntaxhighlight lang="wikitext" inline>{{#expr:{{NUMBEROFUSERS}}+100}}</syntaxhighlight> → ''' {{#expr:{{NUMBEROFUSERS}}+100}}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}}</syntaxhighlight> → '''{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}}'''

{{Warning|1=运算符<code>mod</code>會對第二參數的某些值給出錯誤的结果：
<!-- the following line now produces the correct value:
:<syntaxhighlight lang="wikitext" inline>{{#expr: 123 mod (2^32-1)}}</syntaxhighlight> → '''{{#expr: 123 mod (2^32-1)}}''' (should be 123)<br />
but see this one: -->
:<syntaxhighlight lang="wikitext" inline>{{#expr: 123 mod (2^64-1)}}</syntaxhighlight> → {{#expr: 123 mod (2^64-1)}} （會輸出一個空字符串；但這應該是123）<br />
<!-- and the following bug has now been solved, as shown on the linked bug report:
Depending on the specification and configuration of the server running the wiki, there may also be other errors:
:<syntaxhighlight lang="wikitext" inline>{{#expr: 20060618093259 mod 10000}}</syntaxhighlight> → '''{{#expr: 20060618093259 mod 10000}}''' in most cases, but may occasionally give '''-6357'''. See {{bugzilla|6356}}.
-->
}}
{{tip|1=如果你想要进行基于日期时间的计算（如检测当前日期时间是否超过指定日期时间），首先用<nowiki>{{#time: xNU }}</nowiki>将日期时间转换为距1970年1月1日（UTC）的秒数，再对秒数进行加减运算。}}

<span id="Rounding"></span>
=== 四舍五入 ===

将左边的数字[https://php.net/function.round 四舍五入]为1/10的幂的倍数，指数等于右边给出的数字的截断值（truncated value）。

向上、向下取整分别使用<code>ceil</code>或<code>floor</code>。

{| class="wikitable"
! {{hl1}} | 案例
! {{hl1}} | 结果
! {{hl1}} | 舍入方式
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1/3 round 5 }}</code> || {{#expr: 1/3 round 5 }} || 最终的位數小于5，所以没有明显的取整发生 (0.333333… → 0.33333)
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr: 1/6 round 5 }}</nowiki></code> || {{#expr: 1/6 round 5 }} || 最终的位數大于等於5，所以被向上取整 (0.166666… → 0.16667)
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr: 8.99999/9 round 5 }}</nowiki></code> || {{#expr: 8.99999/9 round 5 }} || 同理，最后一位数因后一位而加1，进而引起了前面的进位 (0.999998… → 1.00000 → 1)
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1234.5678 '''round -2''' }}</code> || {{#expr: 1234.567 round -2 }} || 舍入至最近的整100数，因為负值會舍入到小数点左边。
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1234.5678 '''round 2''' }}</code> || {{#expr: 1234.567 round 2 }} || 舍入至最近的整1/100数，因为正值会舍入至小数点右边。
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1234.5678 round 2'''.3''' }}</code> || {{#expr: 1234.567 round 2.3 }} || 舍入指数的小数点在舍入结果中不起作用
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''trunc''' 1234.5678 }}</code> || {{#expr: trunc 1234.567 }} || 小数部分被全部舍弃（截断）
|-
! colspan=3 {{hl2}} | 四舍五入至最近的整数
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1/3 '''round 0''' }}</code> || {{#expr: 1/3 round 0 }} || 向下取整至0
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1/2 '''round 0''' }}</code> || {{#expr: 1/2 round 0 }} || 向上取整至1
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 3/4 '''round 0''' }}</code> || {{#expr: 3/4 round 0 }} || 向上取整至1
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> -1/3 '''round 0''' }}</code> || {{#expr: -1/3 round 0 }} || 向上取整至0
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> -1/2 '''round 0''' }}</code> || {{#expr: -1/2 round 0 }} || 向下取整至-1
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> -3/4 '''round 0''' }}</code> || {{#expr: -3/4 round 0 }} || 向下取整至-1
|-
! colspan=3 {{hl2}} | 使用ceil和floor向上或向下取整
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''ceil('''1/3''')''' }}</code> || {{#expr: ceil(1/3) }} || 向上取整至1
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''floor('''1/3''')''' }}</code> || {{#expr: floor(1/3) }} || 向下取整至0
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''ceil('''-1/3''')''' }}</code> || {{#expr: ceil(-1/3) }} || 向上取整至0
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''floor('''-1/3''')''' }}</code> || {{#expr: floor(-1/3) }} || 向下取整至-1
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> '''ceil''' 1/3 }}</code> || {{#expr: ceil 1/3 }} || 没有取整，因为1本来就是整数<br />{{Warning|1=注意会被解析为'''(ceil''' 1''')'''/3，而不是你想象中的'''ceil('''1/3''')'''}}
|-
! colspan=3 {{hl2}} | Rounding large numbers
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1e-92 round 400 }}</code> || {{#expr:1e-92 round 400}}
| 四捨五入到一個非常大的數字會導致無窮大。 因此，給你一個不是無限值的原始值做為答案。
|-
| <code style="white-space:nowrap;"><nowiki>{{#expr:</nowiki> 1e108 round 200 }}</code> || {{#expr:1e108 round 200}}
| 同上。
|}

<span id="Strings"></span>
=== {{LC zh|C|zh-hans=字符串|zh-hant=字串}} ===

表达式函数只用于仅含有数字和运算符号的表达式，而字母字符串和其它符号不在此列。若需要比较字符串，可以用[[#ifeq]]替代。

:<syntaxhighlight lang="wikitext" inline>{{#expr: "a" = "a" }}</syntaxhighlight> → '''{{#expr: "a" = "a" }}'''
:<syntaxhighlight lang="wikitext" inline>{{#expr: a = a }}</syntaxhighlight> → '''{{#expr: a = a }}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: a | a | 1 | 0 }}</syntaxhighlight> → '''{{#ifeq: a | a | 1 | 0 }}'''

== #if ==
这个函数判断一个字符串是否为空。只包含空格的字符串被视为空字符串。

:<syntaxhighlight lang="wikitext" inline>{{#if: 测试字符串 | 测试字符串非空时的取值 | 测试字符串为空或仅包含空白字符时的取值}}</syntaxhighlight>

:<syntaxhighlight lang="wikitext" inline>{{#if: 参数1 | 参数2 | 参数3 }}</syntaxhighlight>

这个函数首先判断参数1是否为空。如果参数1不为空，则输出参数2。如果参数1为空或只包含空白内容（空格、换行等），则输出参数3。

:<syntaxhighlight lang="wikitext" inline>{{#if: | yes | no}}</syntaxhighlight> → '''{{#if: | yes | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#if: string | yes | no}}</syntaxhighlight> → '''{{#if: string | yes | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#if: &nbsp;&nbsp;&nbsp;&nbsp; | yes | no}}</syntaxhighlight> → '''{{#if:        | yes | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#if:


 | yes | no}}</syntaxhighlight> → '''{{#if:


 | yes | no}}'''

字符串内容会被处理为纯文本，因此不会计算数学表达式（参见[[##ifexpr|#ifexpr]]）：

:<syntaxhighlight lang="wikitext" inline>{{#if: 1==2 | yes | no }}</syntaxhighlight> → '''{{#if: 1==2 | yes | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#if: 0 | yes | no }}</syntaxhighlight> → '''{{#if: 0 | yes | no }}'''

最后一个参数（false）可以忽略：

:<syntaxhighlight lang="wikitext" inline>{{#if: foo | yes }}</syntaxhighlight> → ''' {{#if: foo | yes }}'''
:<syntaxhighlight lang="wikitext" inline>{{#if: | yes }}</syntaxhighlight> → ''' {{#if: | yes }}'''
:<syntaxhighlight lang="wikitext" inline>{{#if: foo | | no}}</syntaxhighlight> → ''' {{#if: foo | | no}}'''

该函数可嵌套。为了做到这一点，嵌套内层的#if函数需要按规则完整填写所有参数以符合#if的参数形式。一般至多可嵌套7层，该数也可能为wiki自身限制和内存限制而有变动。
<!--
Here's a nested #if that returns "wowzers" if <nowiki>{{{1}}}</nowiki> is supplied, and "zowzers" if <nowiki>{{{2}}}</nowiki> is supplied (hence "wowzers zowzers" if both are supplied).
In this example, the code is indented; unindented markup for nested parserfunctions quickly becomes unreadable.
Note that a HTML comment is used here, which allows a line break in the source code without including it in the output.
-->

<syntaxhighlight lang="wikitext">
{{#if:测试字符串
|字符串非空时的值
|{{#if:测试字符串
  |字符串非空时的值
  |字符串为空(或只有空格)的值
  }}
}}
</syntaxhighlight>

你可以在<code>#if</code>条件句中以字符串变量代替测试字符串。在这里，你需要在变量名的后面加上<code>|</code>(分隔符)以正确引用字符串。
（因此如果参数没有值，则计算结果为一个空字符串而非"<code><nowiki>{{{1}}}</nowiki></code>"。）

:{{tmpl|0=<code class="mw-highlight"><!--
-->{{((}}#if:{{#tag:span|{{(((}}|class=nb}}{{#tag:span|1|class=cp}}{{red|{{!}}}}{{#tag:span|{{)))}}|class=nb}}{{!}}$1{{!}}$2{{))}}<!--
--></code>
|1=你在变量1里面输入了文本
|2=变量1里面没有文本
}}

参见{{ll|Help:Parser functions in templates}}以了解更多关于解析器函数中变量的相关例子。

{{Anchor|ifeq|IFEQ|Ifeq|IfEq|If equal}}

== #ifeq ==
这个函数判断两个輸入字符串是否相同，並根據結果輸出兩個字符串的其中一個。
如果需要更多的比較和輸出字符串，請考慮使用<code>#switch</code>。

:<code><nowiki>{{#ifeq:</nowiki> ''string 1'' <nowiki>|</nowiki> ''string 2'' <nowiki>|</nowiki> ''value if identical'' <nowiki>|</nowiki> ''value if different'' <nowiki>}}</nowiki></code>

如果两个字符串均为数字，则函数会进行数值的比较：

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: 01 | 1 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: 01 | 1 | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: 0 | -0 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: 0 | -0 | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: 1e3 | 1000 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: 1e3 | 1000 | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}}'''

否则，函数会进行文本的比较（區分大小写）：

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: foo | bar | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: foo | bar | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: foo | Foo | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: foo | Foo | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: "01" | "1" | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: "01" | "1" | equal | not equal}}''' &nbsp;''（对比上面没有引号的例子）''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: 10^3 | 1000 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: 10^3 | 1000 | equal | not equal}}''' &nbsp;''（对比上面带有<code>[[##expr|#expr]]</code>的例子，會先回傳一個有效的整數）''

作为例子，考虑一个已存在的{{ll|Help:Templates|模板}}<code>Template:Timer</code>，该模板利用解析器来選擇兩個標準時間，short和long。
它以参数作为第一个输入来比较字符串“short”&ndash;这没有约定顺序，但是如果参数在第一个则更容易理解。
模板代码定义为:

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: {{{1|}}} | short | 20 | 40 }}</syntaxhighlight>

会产生如下结果：

:<syntaxhighlight lang="wikitext" inline>{{timer|short}}</syntaxhighlight> → '''20'''
:<syntaxhighlight lang="wikitext" inline>{{timer|20}}</syntaxhighlight> → '''40'''
:<syntaxhighlight lang="wikitext" inline>{{timer}}</syntaxhighlight> → '''40'''

{{Warning|1=任何的解析器标签和其它的解析器函数，用在解析器函数中时，都一定会被一个临时生成的独一无二的{{ll|Strip marker|标识码}}替代。这会影响如下比较：

:<code><nowiki>{{#ifeq: &lt;nowiki>foo&lt;/nowiki> | &lt;nowiki>foo&lt;/nowiki> | equal | not equal}}</nowiki></code> → '''{{#ifeq: <nowiki>foo</nowiki> | <nowiki>foo</nowiki> | equal | not equal}} '''
:<code><nowiki>{{#ifeq: &lt;math>foo&lt;/math> | &lt;math>foo&lt;/math> | equal | not equal}}</nowiki></code> → '''{{#ifeq: <math>foo</math> | <math>foo</math> | equal | not equal}} '''
:<code><nowiki>{{#ifeq: {{</nowiki>[[Help:Magic words#Miscellaneous|#tag:]]<nowiki>math|foo}} | {{#tag:math|foo}} | equal | not equal}}</nowiki></code> → '''{{#ifeq: {{#tag:math|foo}} | {{#tag:math|foo}} | equal | not equal}} '''
:<syntaxhighlight lang="wikitext" inline>{{#ifeq: [[foo]] | [[foo]] | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: [[foo]] | [[foo]] | equal | not equal}} '''

如果被比较的字符串由相同的{{ll|Help:Templates|模板}}调用提供，且這個模板包含有这些标签，则条件视为真，但如果是两个内容相同但不同的模板，且這两個模板包含这些标签，則条件视为假。
}}

{{Warning|1=随网站配置的变化，含有{{ll|Help:Magic words#Page names|页面名字的魔术字}}的字符串的字面比较可能会发生错误。 比如说，<nowiki>{{FULLPAGENAME}}</nowiki>这一魔术字随wiki的变化，可能在返回时使开头字母变成大写，也会用下划线替代空格。

为了解决这个问题，将这个魔术字应用到两个参数上:

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: {{FULLPAGENAME: L'Aquila}} | {{FULLPAGENAME}} | equal | not equal}}</syntaxhighlight> → '''equal'''
}}

== #iferror ==

这个函数接收一个输入字符串，返回两个结果中的一个。如果输入字符串包含一个由其他解析器函数（比如<code>[[##expr|#expr]]</code>、<code>[[##time|#time]]</code>和<code>[[##rel2abs|#rel2abs]]</code>）、[[Special:MyLanguage/Help:Templates|模板]]错误（比如模板循环和模板递归）或其他解析器“软错误”生成的<code>class="error"</code>的HTML对象，那么视为真。

:<code><nowiki>{{#iferror:</nowiki> ''test string'' <nowiki>|</nowiki> ''value if error'' <nowiki>|</nowiki> ''value if correct'' <nowiki>}}</nowiki></code>

待返回字符串参数可以省略。若省略<code>correct</code>（正确）字符串参数，则在<code>test string</code>（测试字符串）不出错的情况下函数将返回被测字符串本身。若省略<code>error</code>（错误）字符串参数，则函数将在被测字符串出错时返回空字符串：

:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + 2 }} | error | correct }}</syntaxhighlight> → '''{{#iferror: {{#expr: 1 + 2 }} | error | correct }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + X }} | error | correct }}</syntaxhighlight> → '''{{#iferror: {{#expr: 1 + X }} | error | correct }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + 2 }} | error }}</syntaxhighlight> → '''{{#iferror: {{#expr: 1 + 2 }} | error }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + X }} | error }}</syntaxhighlight> → '''{{#iferror: {{#expr: 1 + X }} | error }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + 2 }} }}</syntaxhighlight> → '''{{#iferror: {{#expr: 1 + 2 }} }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: 1 + X }} }}</syntaxhighlight> → '''&zwnj;{{#iferror: {{#expr: 1 + X }} }}'''<!-- maybe the zwnj protects the trailing space before no output -->
:<syntaxhighlight lang="wikitext" inline>{{#iferror: {{#expr: . }} | error | correct }}</syntaxhighlight> → '''{{#iferror: {{#expr: . }} | error | correct }}'''
:<syntaxhighlight lang="wikitext" inline>{{#iferror: <strong class="error">a</strong> | error | correct }}</syntaxhighlight> → '''{{#iferror: <strong class="error">a</strong> | error | correct }}'''
某些错误可能会导致添加一个追踪分类，使用<code><nowiki>{{#iferror:}}</nowiki></code>不会阻止添加此分类。

== #ifexpr ==

此函数会判断数学表达式并根据其布尔值结果返回对应的字符串：

:<code><nowiki>{{#ifexpr:</nowiki> ''expression'' <nowiki>|</nowiki> ''value if true'' <nowiki>|</nowiki> ''value if false'' <nowiki>}}</nowiki></code>

这里<code>expression</code>输入串将原封不动的作为上面<code>[[##expr|#expr]]</code>的参数进行调用，且表达式运算符是通用的，返回值也将作为布尔表达式进行处理。

输入表达式为空时将视为{{phpi|false}}：

:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: | yes | no}}</syntaxhighlight> → '''{{#ifexpr: | yes | no}}'''

如上面所提，0将视为{{phpi|false}}，非零值将视为{{phpi|true}}，因此这个函数与下面的仅用<code>[[##ifeq|#ifeq]]</code>和<code>[[##expr|#expr]]</code>的表述等价：

:<code><nowiki>{{#ifeq: {{#expr: </nowiki>''expression''<nowiki> }} | 0 | </nowiki> ''value if false'' <nowiki>|</nowiki> ''value if true'' <nowiki>}}</nowiki></code>

除了下面这种情况：所输入表达式为空或者是一个错误表达式（空串会返回一条错误信息，而它不等于0，所以在后者我们会得到<code>value if true</code>）。

:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: = | yes | no }}</syntaxhighlight> → ''' {{#ifexpr: = | yes | no }}'''

相对的

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: {{#expr: = }} | 0 | no | yes }}</syntaxhighlight> → ''' {{#ifeq: {{#expr: = }} | 0 | no | yes }}'''

两个返回值都可以省略，当合适的对应分支被省略时，函数不输出：

:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 1 > 0 | yes }}</syntaxhighlight> → '''{{#ifexpr: 1 > 0 | yes }}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 1 < 0 | yes }}</syntaxhighlight> → ''' {{#ifexpr: 1 < 0 | yes }}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 0 = 0 | yes }}</syntaxhighlight> → ''' {{#ifexpr: 0 = 0 | yes }}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 1 > 0 | | no}}</syntaxhighlight> → ''' {{#ifexpr: 1 > 0 | | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 1 < 0 | | no}}</syntaxhighlight> → ''' {{#ifexpr: 1 < 0 | | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 1 > 0 }}</syntaxhighlight> → ''' {{#ifexpr: 1 > 0 }}'''

支持相等或不等的布尔运算。

:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 0 = 0 or 1 = 0 | yes}}</syntaxhighlight> → '''{{#ifexpr: 0 = 0 or 1 = 0 | yes}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 0 = 0 and 1 = 0 | | no}}</syntaxhighlight> → '''{{#ifexpr: 0 = 0 and 1 = 0 | | no}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 2 > 0 or 1 < 0 | yes}}</syntaxhighlight> → '''{{#ifexpr: 2 > 0 or 1 < 0  | yes}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 2 > 0 and 1 > 0 | yes | no}}</syntaxhighlight> → '''{{#ifexpr: 2 > 0 and 1 > 0 | yes | no}}'''

{{Warning|1=使用<code>[[##ifexpr|#ifexpr]]</code>进行数字比较的结果不总是与<code>[[##ifeq|#ifeq]]</code>和<code>[[##switch|#switch]]</code>的结果一致。 后面两种比较相对于<code>[[##ifexpr|#ifexpr]]</code>而言更加精确，因而未必返回相同结果。
考虑比较下面两个仅有最后一位数不同的数：

:<syntaxhighlight lang="wikitext" inline>{{#ifeq: 12345678901234567 | 12345678901234568 | equal | not equal}}</syntaxhighlight> → '''{{#ifeq: 12345678901234567 | 12345678901234568 | equal | not equal}}'''
:<syntaxhighlight lang="wikitext" inline>{{#switch: 12345678901234567 | 12345678901234568 = equal | not equal}}</syntaxhighlight> → '''{{#switch: 12345678901234567 | 12345678901234568 = equal | not equal}}'''

因为<code>[[##ifeq|#ifeq]]</code>和<code>[[##switch|#switch]]</code>使用的PHP会比较两个整数类型的数，会正确返回预期结果。
然而用<code>[[##ifexpr|#ifexpr]]</code>比较相同的两个数时：

:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 12345678901234567 = 12345678901234568 | equal | not equal}}</syntaxhighlight> → '''{{#ifexpr: 12345678901234567 = 12345678901234568 | equal | not equal}}'''

对于不同的数字，结果实际上是不正确的。
造成<code>[[##ifexpr|#ifexpr]]</code>出错行为的原因是MediaWiki将两个数依字面表达理解成了浮点数，而对于像这样的大数，转换为浮点数由于精度误差会存储为一样的数值，导致出错。<br /><br />
}}

{{Anchor|ifexist|Ifexist|ifExist|IfExist|IFexist|IFEXIST}}

== #ifexist ==
{{hatnote|1=請參閱[[Manual:Checking for page existence|手冊:檢查頁面是否存在]]，以瞭解檢查頁面是否存在的其他不同限制的方法。}}

这个函数将一组字符串作为输入，并翻译成页面标题，然后根据在本地wiki上是否存在该页面而返回对应的值。

:<code><nowiki>{{#ifexist:</nowiki> ''page title'' | ''value if exists'' | ''value if doesn't exist'' <nowiki>}}</nowiki></code>

只要页面存在就会判定为{{phpi|true}}（真值），即便那个页面看上去是空白的（比如像是分类链接或者是{{ll|Help:Magic words|魔术字}}解释页之类的却不包含任何可视内容的页面），或者是{{ll|Help:Redirects|重定向页}}，或者它就是空白页。当且仅当页面是红链时判定为{{phpi|false}}（假值），包括那些曾经存在却被删除的页面。

:<code><nowiki>{{#ifexist:</nowiki> {{FULLPAGENAME}} | exists | doesn't exist <nowiki>}}</nowiki></code> → '''{{#ifexist: {{FULLPAGENAME}} | exists | doesn't exist }}'''
:<code><nowiki>{{#ifexist:</nowiki> XX{{FULLPAGENAME}}XX | exists | doesn't exist <nowiki>}}</nowiki></code> → '''{{#ifexist: XX{{FULLPAGENAME}}XX | exists | doesn't exist }}'''

函数在{{ll|Help:System message|系统消息}}被自定义时返回{{phpi|true}}，对{{ll|Help:Special pages|特殊页面}}的判定则取决于本地软件自身。

:<code><nowiki>{{#ifexist:</nowiki> {{#special:Watchlist}} | exists | doesn't exist <nowiki>}}</nowiki></code> → '''{{#ifexist: Special:Watchlist | exists | doesn't exist }}'''
:<code><nowiki>{{#ifexist:</nowiki> {{#special:CheckUser}} | exists | doesn't exist <nowiki>}}</nowiki></code> → {{#ifexist: Special:Checkuser | '''exists''' （因为{{ll|Extension:Checkuser|nsp=0}}扩展已经安装于此wiki） | '''doesn't exist''' （因为{{ll|Extension:Checkuser|nsp=0}}未安装于此wiki） }}
:<code><nowiki>{{#ifexist: MediaWiki:Copyright | exists | doesn't exist }}</nowiki></code> → {{#ifexist: MediaWiki:Copyright | '''exists''' （因为[[{{ns:8}}:Copyright]]已自定义） | '''doesn't exist''' （因为[[{{ns:8}}:Copyright]]未自定义） }}

如果一个页面使用了<code>#ifexist:</code>来检查目标页面，则这个检查页面将出现在被检查页面的[[{{#special:WhatLinksHere}}]]里。所以如果本页面（{{FULLPAGENAME}}）使用了代码 <code><nowiki>{{#ifexist:Foo}}</nowiki></code>，那么[[{{#special:WhatLinksHere}}/Foo]]将列出{{FULLPAGENAME}}。

若wiki有其在使用的对应的共享媒体库，<code>#ifexist:</code>就可用于检查一个文件是否在媒体库中，而不仅仅只是在wiki本体上检查：

:<code><nowiki>{{#ifexist:</nowiki> {{ns:File}}:Example.png <nowiki>| exists | doesn't exist }}</nowiki></code> → '''{{#ifexist: {{ns:File}}:Example.png | exists | doesn't exist }}'''
:<code><nowiki>{{#ifexist:</nowiki> Image:Example.png <nowiki>| exists | doesn't exist }}</nowiki></code> → '''{{#ifexist: Image:Example.png | exists | doesn't exist }}'''
:<code><nowiki>{{#ifexist:</nowiki> {{ns:-2}}:Example.png <nowiki>| exists | doesn't exist }}</nowiki></code> → '''{{#ifexist: {{ns:-2}}:Example.png | exists | doesn't exist }}'''

如果文件有一个已创建的对应的本地描述页面，上面的结果将全部是'''exists'''。

<code>#ifexist:</code>不会对跨wiki链接起作用。

<span id="ifexist_limits"></span>
=== ifexist 限制 ===
<code>#ifexist:</code>被视为“高开销（expensive）解析器函数”，每个页面调用这类函数的次数（包括包含于嵌入式模板的函数）存在一个限制。
当达到该限制时，更多的<code>#ifexist:</code>函数，无论其目标页面是否存在，只会自动返回错误值false，且该页面会被分类到[[:Category:{{MediaWiki:expensive-parserfunction-category}}]]中。
{{ll|Help:Tracking categories|追踪分类}}的名稱可能因您的wiki内容的语言而异。

一些情况下，在css中使用选择器<code>a.new</code>（以选出链接到不存在的页面的链接）或者是<code>a:not(.new)</code>（以选出已存在页面的链接），是可以达到模仿ifexist的效果的。
另外，<code>{{ll|Manual:$wgExpensiveParserFunctionLimit|$wgExpensiveParserFunctionLimit}}</code>可以调整对高开销解析器函数数量的限制，如果有需要，也可以增加页面LocalSettings.php中的限制值。

<span id="ifexist_and_wanted_pages"></span>
=== ifexisit和需要的页面 ===
一个不存在的页面被#ifexist检测后会被计数在[[Special:MyLanguage/Manual:WantedPages|待创建页面]]中。
请参阅{{phab|T14019}}了解原因，并查看[[w:Template:Linkless exists]]以了解解决方法。

== #rel2abs ==
这个函数将文件的相对路径转换为绝对路径。

:<code><nowiki>{{#rel2abs:</nowiki> ''path'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#rel2abs:</nowiki> ''path'' <nowiki>|</nowiki> ''base path'' <nowiki>}}</nowiki></code>

在输入项<code>path</code>中，可以使用以下类型的句法：

*<code>.</code> → 本级路径
*<code>..</code> → 回到上一级
*<code>/foo</code> → 向下一级进入子目录/foo

若<code>base path</code>没有指定，将默认的填入函数所在页面的绝对路径：

:<code><nowiki>{{#rel2abs:</nowiki> /quok   | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: /quok | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ./quok  | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ./quok | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ../quok | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../quok | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ../.    | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../. | {{ns:12}}:Foo/bar/baz }}'''

无效语法，如<code>/.</code>或<code>/./</code>，将被忽略。
由于不允许超过两个连续的句号，因此可以使用诸如此类的序列来分隔连续的语句：

:<code><nowiki>{{#rel2abs:</nowiki> ../quok/.        | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../quok/. | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ../../quok       | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../../quok | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ../../../quok    | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../../../quok | {{ns:12}}:Foo/bar/baz }}'''
:<code><nowiki>{{#rel2abs:</nowiki> ../../../../quok | {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki></code> → '''{{#rel2abs: ../../../../quok | {{ns:12}}:Foo/bar/baz }}'''

針對一個類似的函數群組，另見[[Special:MyLanguage/Help:Magic words#URL data|Help:Magic words#URL data]]。
內建的解析器函數包含：'localurl:', 'fullurl:', 'anchorencode:' 等等。

== #switch ==
''参见： [[w:Help:Switch parser function]]''

该函数将一个输入值同若干个测试用例（test cases）做比较，如果找到匹配，返回有关联的字符串。

{{pre|1=
<nowiki>{{#switch:</nowiki> ''comparison string''
 {{!}} ''case'' = ''result''
 {{!}} ''case'' = ''result''
 {{!}} ''...''
 {{!}} ''case'' = ''result''
 {{!}} ''default result''
<nowiki>}}</nowiki>
}}

例如：

:<syntaxhighlight lang="wikitext" inline>{{#switch: baz | foo = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' {{#switch: baz | foo = Foo | baz = Baz | Bar }} '''
:<syntaxhighlight lang="wikitext" inline>{{#switch: foo | foo = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' {{#switch: foo | foo = Foo | baz = Baz | Bar }} '''
:<syntaxhighlight lang="wikitext" inline>{{#switch: zzz | foo = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' {{#switch: zzz | foo = Foo | baz = Baz | Bar }} '''

含有部分嵌入包含标记的<nowiki>#</nowiki>switch会影响到能让不熟悉模板代码的编辑者查看和编辑可配置元素的配置文件。

<span id="Default"></span>
=== 默认 ===

如果<code>''comparison string''</code>不能与任何<code>''case''</code>匹配，则返回<code>''default result''</code>：

:<syntaxhighlight lang="wikitext" inline>{{#switch: test | foo = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' {{#switch: test | foo = Foo | baz = Baz | Bar }} '''

在这种语法中，默认返回值必须是函数的最后一个参数，而且不能包含原始等号（不帶<code><nowiki>{{}}</nowiki></code>的等號）。
否则，就会解析为样例比较，无匹配的样例时不显示文本。
这是因为默认值没有定义（是空的）。
如果有样例匹配，则返回关联的字符串。

:<syntaxhighlight lang="wikitext" inline>{{#switch: test | Bar | foo = Foo | baz = Baz }}</syntaxhighlight>&nbsp;→ ''' {{#switch: test | Bar | foo =Foo | baz =Baz }} '''<!-- do not remove the spaces between «''' {{» and «}} '''» -->
:<syntaxhighlight lang="wikitext" inline>{{#switch: test | foo = Foo | baz = Baz | B=ar }}</syntaxhighlight>&nbsp;→ ''' {{#switch: test | foo = Foo | baz = Baz | B=ar }} '''<!-- do not remove the spaces between «''' {{» and «}} '''» -->
:<syntaxhighlight lang="wikitext" inline>{{#switch: test | test = Foo | baz = Baz | B=ar }}</syntaxhighlight>&nbsp;→ ''' {{#switch: test | test = Foo | baz = Baz | B=ar }} '''<!-- do not remove the spaces between «''' {{» and «}} '''» -->

你也可以将<code>''case''</code>字符串设为''<code>#default</code>''从而清楚地声明默认值。

{{pre|1=
<nowiki>{{#switch:</nowiki> ''comparison string''
 {{!}} ''case'' = ''result''
 {{!}} ''case'' = ''result''
 {{!}} ''...''
 {{!}} ''case'' = ''result''
 {{!}} #default = ''default result''
<nowiki>}}</nowiki>
}}

这种方式声明的默认结果可以放在函数的任何地方：

:<syntaxhighlight lang="wikitext" inline>{{#switch: test | foo = Foo | #default = Bar | baz = Baz }}</syntaxhighlight> → ''' {{#switch: test | foo = Foo | #default = Bar | baz = Baz }} '''

如果<code>"default"</code>参数被省略，且没有找到匹配，则不返回结果：

:<syntaxhighlight lang="wikitext" inline>{{#switch: test | foo = Foo | baz = Baz }}</syntaxhighlight> → ''' {{#switch: test | foo = Foo | baz = Baz }} '''<!-- do not remove the spaces between «''' {{» and «}} '''» -->

<span id="Grouping_results"></span>
=== 分组结果 ===

该函数允许有“fall through”值，多个<code>''case''</code>字符串返回相同的<code>''result''</code>字符串，从而减少重复。

{{pre|1=
<nowiki>{{#switch:</nowiki> ''comparison string''
 {{!}} ''case1'' = ''result1''
 {{!}} ''case2'' 
 {{!}} ''case3'' 
 {{!}} ''case4'' = ''result234''
 {{!}} ''case5'' = ''result5''
 {{!}} ''case6'' 
 {{!}} ''case7'' = ''result67''
 {{!}} #default = ''default result''
<nowiki>}}</nowiki>
}}

在本例中，第2、3、4个分支都会返回<code>''result234''</code>，第6和第7个分支都会返回<code>''result67''</code>。
上述案例中，最后一个参数中的“<code>#default = </code>”可以省略。

<span id="Use_with_parameters"></span>
=== 带有参数使用 ===
该函数允许将参数用作测试字符串。
在這種情況下，不必将管道符放在参数名称后面，因为你不太可能會选择字符串“<code><nowiki>{{{</nowiki>''parameter name''<nowiki>}}}</nowiki></code>”作为样例。
(如果没有管道符，且参数不存在或没有值，则参数就會預設为这样的值。
参见{{ll|Help:Parser functions in templates}}。)

:<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | foo = Foo | baz = Baz | Bar }}</syntaxhighlight>

上面的例子中，如果<code><nowiki>{{{1}}}</nowiki></code>等于<code>foo</code>，函数返回<code>Foo</code>。
如果等于<code>baz</code>，函数返回<code>Baz</code>。
如果参数是空的或者不存在，函数返回<code>Bar</code>。

上面的这些中，也可以将样例组合起来以返回单个结果。

:<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | Bar }}</syntaxhighlight>

如果<code><nowiki>{{{1}}}</nowiki></code>等于<code>foo</code>、<code>zoo</code>或<code>roo</code>，函数返回<code>Foo</code>。
如果等于<code>baz</code>，函数返回<code>Baz</code>。
如果参数是空的或者不存在，函数返回<code>Bar</code>。

而且，如果你希望在测试参数不能匹配任何样例时不返回任何内容，可以省略默认结果。

:<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | foo = Foo | bar = Bar }}</syntaxhighlight>

在本例中，如果<code><nowiki>{{{1}}}</nowiki></code>存在且等于<code>foo</code>或<code>bar</code>，则分别返回<code>Foo</code>或<code>Bar</code>，否则不返回任何内容。

这样做相当于将默认值声明为空。

:<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | }}</syntaxhighlight>

如果由于某些原因需要将样例设置为<code><nowiki>{{{</nowiki>''parameter name''<nowiki>}}}</nowiki></code>，则函数在参数不存在或没有值的情况下返回该样例的结果。
参数需要存在且拥有不同于字符串“<code><nowiki>{{{</nowiki>''parameter name''<nowiki>}}}</nowiki></code>”的值以返回函数的默认结果。

:（若<code><nowiki>{{{1}}}</nowiki></code>不存在或者是空的）：
::<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' Foo '''
:（若<code><nowiki>{{{1}}}</nowiki></code>的值为<code>test</code>）：
::<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' Bar '''
:（若<code><nowiki>{{{1}}}</nowiki></code>的值为<code><nowiki>{{{1}}}</nowiki></code>）：
::<syntaxhighlight lang="wikitext" inline>{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}</syntaxhighlight> → ''' Foo '''

在这样的例子中，你需要给参数添加管道符（<code><nowiki>{{{1</nowiki><span style="color:red; font-weight:bold">|</span><nowiki>}}}</nowiki></code>）。

<span id="Comparison_behavior"></span>
=== 比较行为 ===

如同<code>[[##ifeq|#ifeq]]</code>那样，若被比较字符串和测试用例字符串都是数字，那么按照数值进行比较；反之若存在一个非纯数字串，都会按照字符串比较规则进行：

:<syntaxhighlight lang="wikitext" inline>{{#switch: 0 + 1 | 1 = one | 2 = two | three}}</syntaxhighlight>&nbsp;→ '''{{#switch: 0 + 1 | 1 = one | 2 = two | three}}'''
:<syntaxhighlight lang="wikitext" inline>{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}}</syntaxhighlight>&nbsp;→ '''{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}}'''
:<syntaxhighlight lang="wikitext" inline>{{#switch: 02 | +1 = one | +2 = two | three}}</syntaxhighlight>&nbsp;→ '''{{#switch: 02 | +1 = one | +2 = two | three}}'''
:<syntaxhighlight lang="wikitext" inline>{{#switch: 100 | 1e1 = ten | 1e2 = hundred | other}}</syntaxhighlight>&nbsp;→ '''{{#switch: 100 | 1e1 = ten | 1e2 = hundred | other}}'''

:<syntaxhighlight lang="wikitext" inline>{{#switch: a | a = A | b = B | C}}</syntaxhighlight>&nbsp;→ '''{{#switch: a | a = A | b = B | C}}'''
:<syntaxhighlight lang="wikitext" inline>{{#switch: A | a = A | b = B | C}}</syntaxhighlight>&nbsp;→ '''{{#switch: A | a = A | b = B | C}}'''

<code>''case''</code>字符串可以是空的：

:<syntaxhighlight lang="wikitext" inline>{{#switch: | = Nothing | foo = Foo | Something }}</syntaxhighlight> → '''{{#switch: | = Nothing | foo = Foo | Something }}'''

只要找到一个匹配，后面的<code>''case''</code>都会忽略：

:<syntaxhighlight lang="wikitext" inline>{{#switch: b | f = Foo | b = Bar | b = Baz | }}</syntaxhighlight> → '''{{#switch: b | f = Foo | b = Bar | b = Baz | }}'''

{{Warning|1=
<code>[[##switch|#switch]]</code>和<code>[[##ifeq|#ifeq]]</code>的数值比较结果未必一致（参见上面<code>[[##ifeq|#ifeq]]</code>部分）：

:<syntaxhighlight lang="wikitext" inline>{{#switch: 12345678901234567 | 12345678901234568 = A | B}}</syntaxhighlight>&nbsp;→ '''{{#switch: 12345678901234567 | 12345678901234568 = A | B}}'''
:<syntaxhighlight lang="wikitext" inline>{{#ifexpr: 12345678901234567 = 12345678901234568 | A | B}}</syntaxhighlight>&nbsp;→ '''{{#ifexpr: 12345678901234567 = 12345678901234568 | A | B}}'''
}}

<span id="Raw_equal_signs"></span>
=== 原始等号 ===

“case”字符串不能包含原始等号。可以使用魔術字符[[Special:MyLanguage/Help:Magic words#Other|{{((}}={{))}}]]創建一個仅包含一个等号: $code1的模板$tpl去繞開它，或者是用HTML标识码<code><nowiki>&amp;#61;</nowiki></code>来代替。

例如：

{| class="wikitable"
! 您输入的
! 您输出的
|-
| <syntaxhighlight lang=wikitext>
{{#switch: 1=2
 | 1=2 = raw
 | 1<nowiki>=</nowiki>2 = nowiki
 | 1{{=}}2 = template
 | default
}}
</syntaxhighlight>
| '''{{#switch: 1=2 | 1=2 = raw | 1<nowiki>=</nowiki>2 = nowiki | 1{{=}}2 = template | default }}'''
|-
| <syntaxhighlight lang=wikitext>
{{#switch: 1=2
 | 1&#61;2 = html
 | default
}}
</syntaxhighlight>
| '''{{#switch: 1=2 | 1&#61;2 = html | default }}'''
|}

{{note|1=为助您理解，您可以检查[https://en.wikipedia.org/w/index.php?title=Template:NBA_color&action=edit&oldid=600531646 模板:NBA球队代表色]。{{ll|Template:Extension}}和[[w:Template:BOTREQ]]是两个使用该函数的复杂例子。
}}

<span id="Replacing_#ifeq"></span>
=== 替换#ifeq ===

<code>#switch</code>可以用于减少[[Special:MyLanguage/Help:Expansion depth|擴張深度]]。

例如：

* <syntaxhighlight lang="wikitext" inline>{{#switch:{{{1}}} |condition1=branch1 |condition2=branch2 |condition3=branch3 |branch4}}</syntaxhighlight>

等效于

* <syntaxhighlight lang="wikitext" inline>{{#ifeq:{{{1}}}|condition1 |branch1 |{{#ifeq:{{{1}}}|condition2 |branch2 |{{#ifeq:{{{1}}}|condition3 |branch3 |branch4}}}}}}</syntaxhighlight>

也就是线性的深度迭代判断：

<syntaxhighlight lang="wikitext">
{{#ifeq:{{{1}}}|condition1
  |<!--then-->branch1
  |<!--else-->{{#ifeq:{{{1}}}|condition2
                |<!--then-->branch2
                |<!--else-->{{#ifeq:{{{1}}}|condition3
                              |<!--then-->branch3
                              |<!--else-->branch4}}}}}}
</syntaxhighlight>

另一方面，对于嵌套在两个分支中的if（以缩进形式呈现，两侧都缩进），替换成switch可能很复杂/不切实际，从而形成对称树：

<syntaxhighlight lang="wikitext">
{{#ifeq:{{{1}}}|condition1
 |<!--then-->branch1t{{
  #ifeq:{{{1}}}|condition2
   |<!--then-->branch1t2t{{#ifeq:{{{1}}}|condition4|<!--then-->branch1t2t4t|<!--else-->branch1t2t4e}}
   |<!--else-->branch1t2e{{#ifeq:{{{1}}}|condition5|<!--then-->branch1t2e5t|<!--else-->branch1t2e5e}}
  }}
 |<!--else-->branch1e{{#ifeq:{{{1}}}|condition3
   |<!--then-->branch1e3t{{#ifeq:{{{1}}}|condition6|branch1e3t6t|branch1e3t6e}}
   |<!--else-->branch1e3e{{
    #ifeq:{{{1}}}|condition7
     |branch1e3e7t
     |branch1e3e7t
    }}
  }}
}}
</syntaxhighlight>

{{Anchor|time|TIME}}

== #time ==
{| class="wikitable plainlinks" style="float: {{dir|{{pagelang}}|left|right}}; font-size: 90%; line-height: normal; margin-{{dir|{{pagelang}}|right|left}}: 1em; width: 40%;"
|-
! {{hl1}} | {{LC zh|C|zh-hans=代码|zh-hant=程式碼}}
! {{hl1}} | 描述
! {{hl1}} | 当前输出<br /><small class="noprint">（[{{fullurl:Help:Extension:ParserFunctions{{#translation:}}|action=purge}} 刷新此页面的缓存]以更新）</small>
|-
! {{hl2}} colspan="3"| 年
|-
| style="text-align: center;" | <code>Y</code>
| 4位数年。
| style="text-align: center;" | {{#time:Y}}
|-
| style="text-align: center;" | <code>y</code>
| 2位数年。
| style="text-align: center;" | {{#time:y}}
|-
| style="text-align: center;" | <code>L</code>
| 如果是闰年则为1，否则为0。
| style="text-align: center;" | {{#time:L}}
|-
| style="text-align: center;" | <code>o</code>{{#tag:ref|需要 PHP 5.1.0 及更新版本和 [[rev:45208]].|group=note}}
| 指定周的ISO-8601年。{{#tag:ref|这拥有与Y相同的值，除了当ISO周数（W）属于去年或明年时，会改用那一年。|group=note}}
| style="text-align: center;" | {{#time:o}}{{#tag:ref|如果未满足注释1，将输出文字“o”。|group=note}}
|-
| colspan="3" style="font-size: 88%;" |<references group="note"/>
|-
! {{hl2}} colspan="3"| 月
|-
| style="text-align: center;" | <code>n</code>
| 月指数，非零填充。
| style="text-align: center;" | {{#time:n}}
|-
| style="text-align: center;" | <code>m</code>
| 月指数，零填充。
| style="text-align: center;" | {{#time:m}}
|-
| style="text-align: center;" | <code>M</code>
| 月名的缩写，使用网站语言。
| style="text-align: center;" | {{#time:M}}
|-
| style="text-align: center;" | <code>F</code>
| 使用网站语言的完整月名。
| style="text-align: center;" | {{#time:F}}
|-
| style="text-align: center;" | <code>xg</code>
| 不同于[[w:zh:主格|主格]]形式，以[[w:zh:所有格|所有格]]形式返回月份名的全称。这个代码适用大多数的[[w:zh:斯拉夫语言|斯拉夫语言]]，比如波兰语、俄语、白俄罗斯语、捷克语、斯洛伐克语、斯洛文尼亚语、乌克兰语等。
| style="line-height: 1.6;" | 波兰语：<br /><code style="font-size: 85%;"><nowiki>{{#time:F Y|June 2010|pl}}</nowiki></code> → {{#time:F Y|June 2010|pl}}<br />（主格）<br /><code style="font-size: 85%;"><nowiki>{{#time:d xg Y|20 June 2010|pl}}</nowiki></code> → {{#time:d xg Y|20 June 2010|pl}}<br />（所有格）
|-
! {{hl2}} colspan="3"| 一年或一个月内的第几天
|-
| style="text-align: center;" | <code>j</code>
| 月内的第几天，没有前缀零。
| style="text-align: center;" | {{#time:j}}
|-
| style="text-align: center;" | <code>d</code>
| 月内的第几天，用前缀零填满两位。
| style="text-align: center;" | {{#time:d}}
|-
| style="text-align: center;" | <code>z</code>
| 年内的第几天（一月一日视为第0天）。<br />{{note}}要获得ISO日期值请在此数基础上加1。
| style="text-align: center;" | {{#time:z}}
|-
! {{hl2}} colspan="3"| 周，以及周内的第几天
|-
| style="text-align: center;" | <code>W</code>
| ISO 8601周数，有前缀零。
| style="text-align: center;" | {{#time:W}}
|-
| style="text-align: center;" | <code>N</code>
| ISO 8601 一周中的某天（星期一为1, 星期日为7）。
| style="text-align: center;" | {{#time:N}}
|-
| style="text-align: center;" | <code>w</code>
| 一周内的某天（星期日为0，星期六为6）。
| style="text-align: center;" | {{#time:w}}
|-
| style="text-align: center;" | <code>D</code>
| 星期几的简写。很少国际化。
| style="text-align: center;" | {{#time:D}}
|-
| style="text-align: center;" | <code>l</code>
| 星期几的全称。很少国际化。
| style="text-align: center;" | {{#time:l}}
|-
! {{hl2}} colspan="3"| 小时
|-
| style="text-align: center;" | <code>a</code>
| 上午（00:00:00 → 11:59:59）返回“am”, 下午（12:00:00 → 23:59:59）返回“pm”。
| style="text-align: center;" | {{#time:a}}
|-
| style="text-align: center;" | <code>A</code>
| 上面的<code>a</code>项的大写版本。
| style="text-align: center;" | {{#time:A}}
|-
| style="text-align: center;" | <code>g</code>
| 十二小时制的小时数（无前缀零）。
| style="text-align: center;" | {{#time:g}}
|-
| style="text-align: center;" | <code>h</code>
| 十二小时制的小时（有前缀零）。
| style="text-align: center;" | {{#time:h}}
|-
| style="text-align: center;" | <code>G</code>
| 二十四小时制的小时（无前缀零）。
| style="text-align: center;" | {{#time:G}}
|-
| style="text-align: center;" | <code>H</code>
| 二十四小时制的小时（有前缀零）。
| style="text-align: center;" | {{#time:H}}
|-
! {{hl2}} colspan="3"| 分钟和秒钟
|-
| style="text-align: center;" | <code>i</code>
| 一小时内已过去的分钟数（有前缀零）。
| style="text-align: center;" | {{#time:i}}
|-
| style="text-align: center;" | <code>s</code>
| 一分钟内已过去的秒数（有前缀零）。
| style="text-align: center;" | {{#time:s}}
|-
| style="text-align: center;" | <code>U</code>
| [[w:zh:Unix时间|Unix时间]]。 自1970年1月1日00:00:00 GMT的秒数。
| style="text-align: center;" | {{#time:U}}
|-
! id="TimeZone" {{hl2}} colspan="3"| 时区（截至[[MediaWiki_1.22/Roadmap|1.22wmf2]]）
|-
| style="text-align: center;" | <code>e</code>
| 时区标识符。
| style="text-align: center;" | {{#time:e}}
|-
| style="text-align: center;" | <code>I</code>
| 是否使用夏令时。
| style="text-align: center;" | {{#time:I}}
|-
| style="text-align: center;" | <code>O</code>
| 与格林尼治时间（GMT）的差值
| style="text-align: center;" | {{#time:O}}
|-
| style="text-align: center;" | <code>P</code>
| 与格林威治时间（GMT）的差异，带冒号
| style="text-align: center;" | {{#time:P}}
|-
| style="text-align: center;" | <code>T</code>
| 时区缩写。
| style="text-align: center;" | {{#time:T}}
|-
| style="text-align: center;" | <code>Z</code>
| 时区偏移（秒）。
| style="text-align: center;" | {{#time:Z}}
|-
! {{hl2}} colspan="3"| 杂项
|-
| style="text-align: center;" | <code>t</code>
| 本月日数。
| style="text-align: center;" | {{#time:t}}
|-
| style="text-align: center;" | <code>c</code>
| ISO 8601格式化日期，与<code>Y-m-d"T"H:i:s+00:00</code>等效。
| style="font-size: 75%;" | {{#time:c}}
|-
| style="text-align: center;" | <code>r</code>
| [[rfc5322|RFC 5332]]格式化的日期。与<code>D, j M Y H:i:s +0000</code>等价，但週名和月名可能不是国际化表述。
| style="font-size: 75%;" | {{#time:r}}
|-
! {{hl2}} colspan="3" | 非公历（格里历）历法
|-
! {{hl3}} colspan="3" | 伊斯兰教历法
|-
| style="text-align: center;" | <code>xmj</code>
| 月内一日。
| {{#time:xmj}}
|-
| style="text-align: center;" | <code>xmF</code>
| 月的全名。
| {{#time:xmF}}
|-
| style="text-align: center;" | <code>xmn</code>
| 月索引。
| {{#time:xmn}}
|-
| style="text-align: center;" | <code>xmY</code>
| 全年。
| {{#time:xmY}}
|-
! {{hl3}} colspan="3" | 伊朗历法（Jalaly）
|-
| style="text-align: center;" | <code>xit</code>
| 月内日数。
| {{#time:xit}}
|-
| style="text-align: center;" | <code>xiz</code>
| 年内一日。
| {{#time:xiz}}
|-
| style="text-align: center;" | <code>xij</code>
| 月内一日。
| {{#time:xij}}
|-
| style="text-align: center;" | <code>xiF</code>
| 月的全名。
| {{#time:xiF}}
|-
| style="text-align: center;" | <code>xin</code>
| 月索引。
| {{#time:xin}}
|-
| style="text-align: center;" | <code>xiY</code>
| 全年。
| {{#time:xiY}}
|-
| style="text-align: center;" | <code>xiy</code>
| 2位数年。
| {{#time:xiy}}
|-
! {{hl3}} colspan="3" | 希伯来历法
|-
| style="text-align: center;" | <code>xjj</code>
| 月内一日。
| {{#time:xjj}}
|-
| style="text-align: center;" | <code>xjF</code>
| 月的全名。
| {{#time:xjF}}
|-
| style="text-align: center;" | <code>xjt</code>
| 月内日数。
| {{#time:xjt}}
|-
| style="text-align: center;" | <code>xjx</code>
| 月份名称的所有格形式。
| {{#time:xjx}}
|-
| style="text-align: center;" | <code>xjn</code>
| 月数。
| {{#time:xjn}}
|-
| style="text-align: center;" | <code>xjY</code>
| 全年。
| {{#time:xjY}}
|-
! {{hl3}} colspan="3" | 泰历
|-
| style="text-align: center;" | <code>xkY</code>
| [[w:Thai solar calendar|泰太阳历]]中的年份. <br />{{note}}1941年前后，本条目可能与依泰历的真实[[w:Thai_solar_calendar#New_year|计算方式]]出的年份有变化.
| {{#time:xkY}}
|-
! {{hl3}} colspan="3" | 民国历/主体历
|-
| style="text-align: center;" | <code>xoY</code>
| 全年。
| {{#time:xoY}}
|-
! {{hl3}} colspan="3" | 日本历法
|-
| style="text-align: center;" | <code>xtY</code>
| 全年。
| {{#time:xtY}}
|-
! {{hl2}} colspan="3" | 标记
|-
| style="text-align: center;" | <code>xn</code>
| 以ASCII原始数字表示的数字代码。
| 在印地语中，<syntaxhighlight lang="wikitext" inline>{{#time:H, xnH}}</syntaxhighlight>产生०६, 06。
|-
| style="text-align: center;" | <code>xN</code>
| colspan="2" | 类似于<code>xn</code>，但是作为一个toggled flag，会持续到字符串的末尾或者字符串中<code>xN</code>下一次出现。
|-
| style="text-align: center;" | <code>xr</code>
| 将下一个数字格式化为罗马数字。仅适用于10000以内的数字<br /><small>（MediaWiki 1.20之前的版本为3000以内）</small>
| <syntaxhighlight lang="wikitext" inline>{{#time:xrY}}</syntaxhighlight> → {{#time:xrY}}
|-
| style="text-align: center;" | <code>xh</code>
| 将下一个数字格式化为希伯来数字。
| <syntaxhighlight lang="wikitext" inline>{{#time:xhY}}</syntaxhighlight> → {{#time:xhY}}
|}

该解析器函数接收一个（公历的）日期或者时间，并根据给定的语法将其格式化。可以指定日期/时间对象，默认则为[[Special:MyLanguage/Help:Magic words#Date and time|魔术字]]Special:MyLanguage/Help:Magic words#Date and time的当前值——也就是说，页面最后被渲染为HTML时的时间。

:<code><nowiki>{{#time:</nowiki> ''format string'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#time:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#time:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>|</nowiki> ''language code'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#time:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>|</nowiki> ''language code'' <nowiki>|</nowiki> ''local'' <nowiki>}}</nowiki></code>

右表列举了支持的格式化代码。
任何不被识别的格式化字符串都不会被修改，这同样适用于空白字符（系统不使用空白字符来解释代码）。
如果格式化字符串中沒有識別到任何字符，且日期/時間物件沒有錯誤，則格式化字符會作為輸出傳回。
格式化字符串内有两种方法来转义字符：

# 反斜杠后跟随一个格式化字符串会被解释为单个原始的字符
# 用英文双引号括起来的字符视为原始字符，引号将被移除。

此外，<code>xx</code>会被解释为单个原始的x。

由于格式化代码列表会持续发展（支持新日历，或支持以不同方式计算和格式化的新日期字段），您应该转义所有需要传入而保持不变的文字字符（不仅仅是格式化代码当前使用的ASCII字母）。

不幸的是，目前，ASCII单引号仍未被视为当前已经受支持的ASCII双引号（可标记文字文本）和反斜杠（在许多语言使用的字符串常量中也必须转义，包括JSON、C、C++、PHP、JavaScript、Lua）的简单替代方法（例如，双引号在其他用途中是强制性的，例如JSON、C、C++等语言中的字符串值的定界）。
因此，您仍然无法在不使用反斜杠转义的情况下嵌入任何文字双引号（或者也可以使用其他弯引号、角形引号或方引号）。

:<syntaxhighlight lang="wikitext" inline>{{#time: Y-m-d }}</syntaxhighlight> → '''{{#time: Y-m-d }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: [[Y]] m d }}</syntaxhighlight> → '''{{#time: [[Y]] m d }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: [[Y (year)]] }}</syntaxhighlight> → '''{{#time: [[Y (year)]] }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: [[Y "(year)"]] }}</syntaxhighlight> → '''{{#time: [[Y "(year)"]] }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: i's" }}</syntaxhighlight> → '''{{#time: i's" }}'''

<code>''date/time object''</code>可以是任何PHP [https://php.net/function.strtotime strtotime()]函数接受的格式。
绝对（如<code>20 December 2000</code>）、相对（如<code>+20 hours</code>）和混合时间（如<code>30 July +1 year</code>）格式均是可以的。

:<syntaxhighlight lang="wikitext" inline>{{#time: r|now}}</syntaxhighlight> → '''{{#time: r|now}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|+2 hours}}</syntaxhighlight> → '''{{#time: r|+2 hours}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|now + 2 hours}}</syntaxhighlight> → '''{{#time: r|now + 2 hours}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|20 December 2000}}</syntaxhighlight> → '''{{#time: r|20 December 2000}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|December 20, 2000}}</syntaxhighlight> → '''{{#time: r|December 20, 2000}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|2000-12-20}}</syntaxhighlight> → '''{{#time: r|2000-12-20}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r|2000 December 20}}</syntaxhighlight> &rarr; '''{{#time: r|2000 December 20}}'''

[[w:zh:ISO 639-3|ISO 639-3]]（?）中的<code>''language code''</code>允许字符串显示为指定语言。

:<syntaxhighlight lang="wikitext" inline>{{#time:d F Y|1988-02-28|nl}}</syntaxhighlight> → '''{{#time:d F Y|1988-02-28|nl}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:l|now|uk}}</syntaxhighlight> → '''{{#time:l|now|uk}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:d xg Y|20 June 2010|pl}}</syntaxhighlight> → '''{{#time:d xg Y|20 June 2010|pl}}'''

<code>''local''</code>参数指定''date/time object''是指本地时区还是UTC时间。

这是一个布尔参数，其值是通过转换（casting）参数值来确定的（有关如何将字符串转换为布尔值的详细信息，请参阅[https://php.net/language.types.boolean#language.types.boolean.casting 官方PHP文档]）。

{{note|2=reminder|1=请注意，如果{{phpi|$wgLocaltimezone}}设为<code>UTC</code>，则当<code>local</code>设为<code>true</code>或<code>false</code>时输出无区别。}}

参考下面的详细示例：

:<syntaxhighlight lang="wikitext" inline>{{#time: Y F d H:i:s|now|it|0}}</syntaxhighlight> → '''{{#time: Y F d H:i:s|now|it|0}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: Y F d H:i:s|now|it|1}}</syntaxhighlight> → '''{{#time: Y F d H:i:s|now|it|1}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: Y F d H:i:s|+2 hours||0}}</syntaxhighlight> → '''{{#time: Y F d H:i:s|+2 hours||0}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: Y F d H:i:s|+2 hours||1}}</syntaxhighlight> → '''{{#time: Y F d H:i:s|+2 hours||1}}'''

:<syntaxhighlight lang="wikitext" inline>{{#time:c|2019-05-16T17:05:43+02:00|it}}</syntaxhighlight> → '''{{#time:c|2019-05-16T17:05:43+02:00|it}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:c|2019-05-16T17:05:43+02:00|it|0}}</syntaxhighlight> → '''{{#time:c|2019-05-16T17:05:43+02:00|it|0}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:c|2019-05-16T17:05:43+02:00|it|true}}</syntaxhighlight> → '''{{#time:c|2019-05-16T17:05:43+02:00|it|true}}'''

如果你已经计算了Unix时间戳，你可以通过添加<code>@</code>符号前缀来在日期计算中使用。

:<syntaxhighlight lang="wikitext" inline>{{#time: U | now }}</syntaxhighlight> → '''{{#time: U | now}}'''
:<code><nowiki>{{#time: r | @</nowiki>{{#time: U}} <nowiki>}}</nowiki></code> → '''{{#time: r | @{{#time:U}} }}'''

{{Warning|1=
若不在數字格式的時間戳值的前面包含<code>@</code>前綴，結果通常會出錯或是未預期的數值：

:<syntaxhighlight lang="wikitext" inline>{{#time: r | 1970-01-01 00:16:39 }}</syntaxhighlight> → '''{{#time: r | 1970-01-01 00:16:39 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: U | 1970-01-01 00:16:39 }}</syntaxhighlight> → '''{{#time: U | 1970-01-01 00:16:39 }}'''
:<code><nowiki>{{#time: r | @</nowiki>{{#time: U | 1970-01-01 00:16:39 }}<nowiki> }}</nowiki></code> → '''{{#time: r | @{{#time: U | 1970-01-01 00:16:39 }} }}''' （正確）
:<code><nowiki>{{#time: r | </nowiki>{{#time: U | 1970-01-01 00:16:39 }}<nowiki> }}</nowiki></code> → '''{{#time: r | {{#time: U | 1970-01-01 00:16:39 }} }}''' （不支援的年份格式）
:<syntaxhighlight lang="wikitext" inline>{{#time: r | 1970-01-01 00:16:40 }}</syntaxhighlight> → '''{{#time: r | 1970-01-01 00:16:40 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: U | 1970-01-01 00:16:40 }}</syntaxhighlight> → '''{{#time: U | 1970-01-01 00:16:40 }}'''
:<code><nowiki>{{#time: r | @</nowiki>{{#time: U | 1970-01-01 00:16:40 }}<nowiki> }}</nowiki></code> → '''{{#time: r | @{{#time: U | 1970-01-01 00:16:40 }} }}''' （正確）
:<code><nowiki>{{#time: r | </nowiki>{{#time: U | 1970-01-01 00:16:40 }}<nowiki> }}</nowiki></code> → '''{{#time: r | {{#time: U | 1970-01-01 00:16:40 }} }}''' （被解讀為某年的当前月份和日期）
:<syntaxhighlight lang="wikitext" inline>{{#time: r | 1970-01-01 02:46:39 }}</syntaxhighlight> → '''{{#time: r | 1970-01-01 02:46:39 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: U | 1970-01-01 02:46:39 }}</syntaxhighlight> → '''{{#time: U | 1970-01-01 02:46:39 }}'''
:<code><nowiki>{{#time: r | @</nowiki>{{#time: U | 1970-01-01 02:46:39 }}<nowiki> }}</nowiki></code> → '''{{#time: r | @{{#time: U | 1970-01-01 02:46:39 }} }}''' （正確）
:<code><nowiki>{{#time: r | </nowiki>{{#time: U | 1970-01-01 02:46:39 }}<nowiki> }}</nowiki></code> → '''{{#time: r | {{#time: U | 1970-01-01 02:46:39 }} }}''' （被解讀為某年的当前月份和日期）
:<syntaxhighlight lang="wikitext" inline>{{#time: r | 1970-01-01 02:46:40 }}</syntaxhighlight> → '''{{#time: r | 1970-01-01 02:46:40 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: U | 1970-01-01 02:46:40 }}</syntaxhighlight> → '''{{#time: U | 1970-01-01 02:46:40 }}'''
:<code><nowiki>{{#time: r | @</nowiki>{{#time: U | 1970-01-01 02:46:40 }}<nowiki> }}</nowiki></code> → '''{{#time: r | @{{#time: U | 1970-01-01 02:46:40 }} }}''' （正確）
:<code><nowiki>{{#time: r | </nowiki>{{#time: U | 1970-01-01 02:46:40 }}<nowiki> }}</nowiki></code> → '''{{#time: r | {{#time: U | 1970-01-01 02:46:40 }} }}''' （不支援的年分格式）
}}

{{Warning|1=
可接受的范围为0111年1月1日（1 January 0111）到9999年12月31日（31 December 9999）。对于年份100到110，输出不连贯，Y和闰年类似于年份100-110，而r、D、I和U可能会将这些年份解释为2000-2010。

:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 29 Feb 0100 }}</syntaxhighlight> → '''{{#time: d F Y | 29 Feb 0100 }}'''<br /> （正確，沒有閏年），但是
:<syntaxhighlight lang="wikitext" inline>{{#time: r | 29 Feb 0100 }}</syntaxhighlight> → '''{{#time: r | 29 Feb 0100 }}''' （錯誤，即使100也被解讀為2000，因为那是閏年）
:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 15 April 10000 }}</syntaxhighlight> → '''{{#time: d F Y | 15 April 10000 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: r | 10000-4-15 }}</syntaxhighlight> → '''{{#time: r | 10000-4-15 }}'''

年份数字0-99解释为2000-2069和1970-1999，除非添加前缀0以写成四位数格式：

:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 1 Jan 6 }}</syntaxhighlight> → '''{{#time: d F Y | 1 Jan 6 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 1 Jan 06 }}</syntaxhighlight> → '''{{#time: d F Y | 1 Jan 06 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 1 Jan 006 }}</syntaxhighlight> → '''{{#time: d F Y | 1 Jan 006 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | 1 Jan 0006 }}</syntaxhighlight> → '''{{#time: d F Y | 1 Jan 0006 }}''' (4-digit format)

年份100-110和1753之后的年份支持工作日，对于年份111-1752，r的输出显示“Unknown”，l输出“<>”，结果，这些年份不支持r输出。
}}

可以指定完整的或部分绝对的日期；函数会使用“当前”值“填充”日期中未被指定的部分。

:<syntaxhighlight lang="wikitext" inline>{{#time: Y | January 1 }}</syntaxhighlight> → '''{{#time: Y | January 1 }}'''

{{Warning|1=
“填充”功能并不连贯，有些部分会使用当前值填充，其他的则不会：

:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | June }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | June }}''' 给予这一天的开始，而不是当前月份中的日期和当前年份。
:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | 2003 }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | 2003 }}''' 给予这一天的开始，而不是这一年的当前日期。

填充日期有特例：

:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | June 2003 }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | June 2003 }}''' 给予这一天的开始和这个月的开始。
}}

4位數字總是被解讀為年分，而不是小時和分鐘：<ref>在2011年{{rev|86805}}之前，情況並非如此。</ref>

:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | 1959 }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | 1959 }}'''

6位數字儘量被解讀為小時、分鐘、秒，不然會被解讀為錯誤（而不是年份和月份）：

:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | 195909 }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | 195909 }}''' 輸入被視為時間而不是年+月代碼。
:<syntaxhighlight lang="wikitext" inline>{{#time: Y m d H:i:s | 196009 }}</syntaxhighlight> → '''{{#time: Y m d H:i:s | 196009 }}''' 雖然19:60:09不是有效時間，但196009不被解讀為1960年9月。

該函數執行一定數量的日期算數：

:<syntaxhighlight lang="wikitext" inline>{{#time: d F Y | January 0 2008 }}</syntaxhighlight> → '''{{#time: d F Y | January 0 2008 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F | January 32 }}</syntaxhighlight> → '''{{#time: d F | January 32 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F | February 29 2008 }}</syntaxhighlight> → '''{{#time: d F | February 29 2008 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: d F | February 29 2007 }}</syntaxhighlight> → '''{{#time: d F | February 29 2007 }}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:Y-F|now -1 months}}</syntaxhighlight> → '''{{#time:Y-F|now -1 months}}'''

<code>#time</code>調用的格式字符串的總長度限制為6000個字符<ref>phabricator.wikimedia.org的[https://phabricator.wikimedia.org/diffusion/EPFN/browse/master/includes/ParserFunctions.php$9 ParserFunctions.php]</ref>。

<span id="Time_Zone_issue"></span>
==== 时区问题 ====

<nowiki>#</nowiki>time解析器函数有个bug（尤其是PHP DateTime），不允许传入非整数的相对时区偏移。这个问题不适用于使用基于小时的时区，例如EDT。例如：

* <syntaxhighlight lang="wikitext" inline>{{#time:g:i A | -4 hours }}</syntaxhighlight> &rarr; {{#time:g:i A | -4 hours}}

但是，印度（India）是UTC +5.5个小时的时间偏移，因此使用时区不会正常地计算相对时区偏移。因此：

* <syntaxhighlight lang="wikitext" inline>{{#time:g:i A | +5.5 hours }}</syntaxhighlight> &rarr; {{#time:g:i A | +5.5 hours }}

要解决这个问题，可将时间简单转换为分钟或者秒，像这样：

* <syntaxhighlight lang="wikitext" inline>{{#time:g:i A | +330 minutes }}</syntaxhighlight> &rarr; {{#time:g:i A | +330 minutes }}
* <syntaxhighlight lang="wikitext" inline>{{#time:g:i A | +19800 seconds }}</syntaxhighlight> &rarr;  {{#time:g:i A | +19800 seconds }}

（Tim Starling，该函数的开发者，提供了该解决方案的准确语法。）

<span id="#time_format_like_in_signatures"></span>
====如同簽名那樣的#time格式====
有時候，建構一個時間戳是很有用的，它看起來就像是討論頁裏面的討論，由[[Special:MyLanguage/Help:Signatures|簽名]]自動產生的時間戳。
在英文wiki上，可以用以下方式建立：

* <syntaxhighlight lang="wikitext" inline>{{#timel:H:i, j xg Y (e)|+330 minutes}}</syntaxhighlight> &rarr; {{#timel:H:i, j xg Y (e)|+330 minutes}}

== #timel ==
该函数是一个语法缩写，作用等价于将<code><nowiki>{{#time: ... }}</nowiki></code>的<code>local</code>参数设置为{{phpi|true}}，因此它始终使用用户的首选时区或wiki的配置时区（在{{ll|Manual:$wgLocaltimezone|$wgLocaltimezone}}中设置）。 

该函数的语法为：

:<code><nowiki>{{#timel:</nowiki> ''format string'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timel:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timel:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>|</nowiki> ''language code'' <nowiki>}}</nowiki></code>

{{note|2=reminder|1=请注意，如果变量{{phpi|$wgLocaltimezone}}设为<code>UTC</code>，则当<code>local</code>设为{{phpi|true}}或{{phpi|false}}时输出无区别。}}

[[File:Time-Timel.png|thumb|使用#time和#timel解析器函数的示例，其中服务器处于非UTC时区]]

例如，参考以下示例：

:<syntaxhighlight lang="wikitext" inline>{{#time:c|now|it}}</syntaxhighlight> → '''{{#time:c|now|it}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:c|now|it|0}}</syntaxhighlight> → '''{{#time:c|now|it|0}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time:c|now|it|1}}</syntaxhighlight> → '''{{#time:c|now|it|1}}'''
:<syntaxhighlight lang="wikitext" inline>{{#timel:c|now|it}}</syntaxhighlight> → '''{{#timel:c|now|it}}'''

[[File:Maldiskusjon Sommertid–Wikipedia.jpg|thumb|https://no.wikipedia.org/wiki/Maldiskusjon:Sommertid的警告範例]]

{{Warning|1=
注意对于time和timel，U会都返回自1970-01-01 00:00:00 UTC（即GMT）的秒数，无论时区是否为UTC。

:<code>U</code> Unix时间。自1970年1月1日 00:00:00（GMT）以来的秒数。
:<code>Z</code> 时区偏移（秒）。
:<syntaxhighlight lang="wikitext" inline>{{#time: U}}</syntaxhighlight> → '''{{#time: U}}'''
:<syntaxhighlight lang="wikitext" inline>{{#timel: U}}</syntaxhighlight> → '''{{#timel: U}}'''
:<syntaxhighlight lang="wikitext" inline>{{#time: Z}}</syntaxhighlight> → '''{{#time: Z}}'''
:<syntaxhighlight lang="wikitext" inline>{{#timel: Z}}</syntaxhighlight> → '''{{#timel: Z}}'''
}}

{{-}}

{{Anchor|timef}}

== #timef ==
This function formats a date using a standard format for the selected language, as defined in <code>[https://codesearch.wmcloud.org/core/?q=dateFormats&files=languages/messages $dateFormats]</code> (see {{Phab|T223772}}).

:<code><nowiki>{{#timef:</nowiki> ''date/time object'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timef:</nowiki> ''date/time object'' <nowiki>|</nowiki> ''format type'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timef:</nowiki> ''date/time object'' <nowiki>|</nowiki> ''format type'' <nowiki>|</nowiki> ''language code'' <nowiki>}}</nowiki></code>

The format of the ''date/time object'' is the same as for [[#time|#time]]. If it is empty, the time when the page was rendered is used.

The ''format type'' may be one of:

; <code>time</code> : Only the time is shown.
; <code>date</code> : Only the date is shown.
; <code>both</code> : Both the time and date are shown.
; <code>pretty</code> : Only the date is shown, using an abbreviated format which does not include the year. Not all languages support this; if it is not supported, the "date" format is used.

If the ''format type'' is not specified, both the time and date will be show, as if <code>both</code> were specified.

If the ''language code'' is not specified, the page's content language is used.

Using <code>#timef</code> instead of <code>#time</code> allows templates to more easily support multiple languages, since different languages have different ways to format dates.

In English, the order of the day and month is controlled by {{wg|AmericanDates}}.

Examples:

:<syntaxhighlight lang="wikitext" inline>{{#timef:now|both|en}}</syntaxhighlight> → ''' {{#timef:now|both|en}} '''
:<syntaxhighlight lang="wikitext" inline>{{#timef:now|both|ja}}</syntaxhighlight> → ''' {{#timef:now|both|ja}} '''
:<syntaxhighlight lang="wikitext" inline>{{#timef:now|pretty|en}}</syntaxhighlight> → ''' {{#timef:now|pretty|en}} '''
:<syntaxhighlight lang="wikitext" inline>{{#timef:now|pretty|pl}}</syntaxhighlight> → ''' {{#timef:now|pretty|pl}} '''
:<syntaxhighlight lang="wikitext" inline>{{#timef:|time}}</syntaxhighlight> → ''' {{#timef:|time}} '''

{{Anchor|timefl}}

== #timefl ==

This function is the same as [[#timef|#timef]] except that it uses the local timezone of the wiki as configured in {{ll|Manual:$wgLocaltimezone|$wgLocaltimezone}}.

:<code><nowiki>{{#timefl:</nowiki> ''date/time object'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timefl:</nowiki> ''date/time object'' <nowiki>|</nowiki> ''format type'' <nowiki>}}</nowiki></code>
:<code><nowiki>{{#timefl:</nowiki> ''date/time object'' <nowiki>|</nowiki> ''format type'' <nowiki>|</nowiki> ''language code'' <nowiki>}}</nowiki></code>

{{Anchor|titleparts}}

== #titleparts ==
此函数将页面标题根据斜杠划分成多个分段，然后输出返回这些分段中的部分。

: {{tmpl|0=<code class="mw-highlight">{{((}}#titleparts: ''$1'' {{!}} ''$2'' {{!}} ''$3'' {{))}}</code>
|1=页面名称
|2=需要返回的分段数量
|3=要返回的第一个分段
}}

如果没有指定''要返回的分段数量''参数，则默认为“0”，会从''要返回的第一个分段''（包含）开始返回所有分段。如果''要返回的第一个分段''参数没有指定或者为“0”，则默认为“1”。
: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">{{ns:1}}:Foo/bar/baz/quok</span> <nowiki>}}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok }}'''
: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">{{ns:1}}:Foo</span>/bar/baz/quok <nowiki>| 1 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | 1 }}''' 参见<nowiki>{{</nowiki>{{ll|Help:Magic_words#Page_names|ROOTPAGENAME}}<nowiki>}}</nowiki>。
: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">{{ns:1}}:Foo/bar</span>/baz/quok <nowiki>| 2 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | 2 }}'''
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/<span style="color: blue;">bar/baz</span>/quok <nowiki>| 2 | 2 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | 2 | 2 }}'''
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/<span style="color: blue;">baz/quok</span> <nowiki>| 2 | 3 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | 2 | 3 }}'''
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/<span style="color: blue;">bar/baz/quok</span> <nowiki>| 3 | 2 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | 3 | 2 }}'''
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/<span style="color: blue;">bar/baz/quok</span> <nowiki>| | 2 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | | 2 }}'''
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/baz/quok <nowiki>| | 5 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | | 5 }} '''

两个值都接受负值。''要返回的分段数量''参数的负值会从字符串的最后开始“剥离”分段。''要返回的第一个分段''参数的负值解释为“从这一分段开始，从右边开始计数”：

: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">{{ns:1}}:Foo/bar/baz</span>/quok <nowiki>| -1 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -1 }}''' 从字符串的末尾剥离一段 参见{{[[Special:MyLanguage/Help:Magic_words#Page_names|BASEPAGENAME]]}}。
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/baz/quok <nowiki>| -4 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -4 }} ''' 从字符串的末尾剥离所有4段
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/baz/quok <nowiki>| -5 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -5 }} ''' 从字符串的末尾剥离5段（多于已存在的）
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/baz/<span style="color: blue;">quok</span> <nowiki>| | -1 }}</nowiki></code> → ''' {{#titleparts: {{ns:1}}:Foo/bar/baz/quok | | -1 }}''' 返回最后一段。 参见{{[[Special:MyLanguage/Help:Magic_words#Page_names|SUBPAGENAME]]}}。
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/<span style="color: blue;">bar/baz</span>/quok <nowiki>| -1 | 2 }}</nowiki></code> → ''' {{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -1 | 2 }}''' 从字符串的末尾剥离一段，然后返回第二段及以后的段
: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/<span style="color: blue;">baz</span>/quok <nowiki>| -1 | -2 }}</nowiki></code> → ''' {{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -1 | -2 }}''' 从倒数第二个元素开始复制；从字符串的末尾剥离一段

处理前，''页面名称''参数是HTML解码的：如果包含一些标准的HTML字符实体，将被转换为纯字符（内部使用UTF-8编码，也就是与使用解析器函数的MediaWiki源页面中的编码相同）。

: 例如，''页面名称''中出现了<code>&amp;quot;</code>、<code>&amp;#34;</code>、<code>&amp;#x22;</code>的地方，都会替换为<code>"</code>。
: 不会执行从HTML到纯文本的其他转换，因此即使HTML标签在页面标题中无效，在此初始步骤中也会保持不变。

{{tip| 1=
MediaWiki的一些魔术字或解析器函数（例如<code><nowiki>{{</nowiki>{{ll|Help:Magic words#Page names|PAGENAME}}<nowiki>}}</nowiki></code>和类似）会返回用多余的HTML编码的字符串，即使其自身的输入参数不是HTML编码的：

titleparts解析器函数可以用作一个解决办法，以转换返回的字符串，因此可以被其他的一些解析器函数正确处理，如果这些<!-- 替换原文中的长定语 -->解析器函数参数中也会接收页面名称，比如<code><nowiki>{{</nowiki>{{ll|Help:Magic words#PAGESINCAT|PAGESINCAT:}}<nowiki>}}</nowiki></code>（但对于HTML编码的字符串仍然不能正确处理）。

例如，如果当前页面是[[commons:Category:Côte-d'Or|Category:Côte-d'Or]]，那么：

* <code><nowiki>{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}</nowiki></code>、<code><nowiki>{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d&amp;apos;Or | 1 | 0 }}</nowiki></code>都会返回<code>1</code>；（#ifeq解析器函数不会对输入参数进行HTML解码）。
* <code><nowiki>{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}</nowiki></code>、<code><nowiki>{{#switch: {{FULLPAGENAME}} | Category:Côte-d&amp;apos;Or = 1 | #default = 0 }}</nowiki></code>都会返回<code>1</code>；（#switch解析器函数不会对输入参数进行HTML解码）。
* <code><nowiki>{{#ifexist: {{FULLPAGENAME}} | 1 | 0 }}</nowiki></code>、<code><nowiki>{{#ifexist: Category:Côte-d'Or | 1 | 0 }}</nowiki></code>甚至<code><nowiki>{{#ifexist: Category:Côte-d&amp;apos;Or | 1 | 0 }}</nowiki></code>都会返回<code>1</code>，如果这个分类页面存在（#ifexpr解析器函数不会对输入参数进行HTML解码）；
* <code><nowiki>{{PAGESINCAT: Côte-d'Or }}</nowiki></code>返回非零数，如果该分类包含页面或子分类，'''但是'''：
* <code><nowiki>{{PAGESINCAT: {{CURRENTPAGENAME}} }}</nowiki></code>可能会'''无条件'''地返回0，就像：
* <code><nowiki>{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}</nowiki></code>
* <code><nowiki>{{PAGESINCAT: {{PAGENAME:Category:Côte-d&amp;apos;Or}} }}</nowiki></code>

这种非预料行为的原因是，对于当前版本的MediaWiki，有两个警告（caveats）：

* <code><nowiki>{{FULLPAGENAME}}</nowiki></code>，或者甚至<code><nowiki>{{FULLPAGENAME:Côte-d'Or}}</nowiki></code>''可能会''返回实际HTML编码的字符串<code>Category:Côte-d&amp;apos;Or</code>而不是预期中的<code>Category:Côte-d'Or</code>；<!-- “and that”不翻译 -->
* <code><nowiki>{{PAGESINCAT: Côte-d&amp;apos;Or }}</nowiki></code>'''无条件地'''返回0（PAGESINCAT魔术字不对输入参数进行任何的HTML解码）。

使用titleparts的简单解决方法（如果上述两个警告在MediaWiki的更高版本中修复了，也会继续生效）：

* <code><nowiki>{{PAGESINCAT: {{#titleparts: {{CURRENTPAGENAME}} }} }}</nowiki></code>
* <code><nowiki>{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}</nowiki></code>
* <code><nowiki>{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d&amp;apos;Or}} }} }}</nowiki></code>，总是返回相同分类中的实际页面数量。
}}

解码后的''页面名称''会尽可能标准化为MediaWiki支持的标准页面名称：

# 所有下划线都自动替换为空格：
#: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bah_boo|1|2}}</code>  → '''{{#titleparts: {{ns:1}}:Foo/bah_boo|1|2}}''' 不是bah_boo，尽管原来的内容有下划线。
# 字符串最多分割25此；更多的斜杠都会忽略，第25个元素将会包含字符串的剩余内容。 字符串也限制在255个字符内，因为要被视为[[Special:MyLanguage/Manual:Page table#Schema summary|页面标题]]：
#: <code><nowiki>{{#titleparts:</nowiki> a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/<span style="color: blue;">y/z/aa/bb/cc/dd/ee</span> <nowiki>| 1 | 25 }}</nowiki></code> → '''{{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee | 1 | 25 }}'''
#: 如果出于某些原因确实要将此函数推到极限（尽管不太可能），可以通过嵌套函数调用来绕过只能分割25此的限制：
#: <code><nowiki>{{#titleparts: {{#titleparts:</nowiki> a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/<span style="color: blue;">z</span>/aa/bb/cc/dd/ee<nowiki>| 1 | 25 }} | 1 | 2}}</nowiki></code> → '''{{#titleparts: {{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee | 1 | 25 }} | 1 | 2}}'''
# 最后，第一个子字符串根据本地wiki的大小写设置进行大写（如果该子字符串也以本地命名空间名称开头，则该命名空间名称也被标准化）。
#: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">talk:a</span>/b/c <nowiki>}}</nowiki></code> → '''{{#titleparts: talk:a/b/c }}'''

{{tip| 1=
您可以把#titleparts用作一个小的“字符串解析器和转换器”，但要考虑到返回第一个子字符串会大写：

: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">one</span>/two/three/four<nowiki>|1|1 }}</nowiki></code> → '''{{#titleparts: one/two/three/four|1|1 }}'''
: <code><nowiki>{{#titleparts:</nowiki> one/<span style="color: blue;">two</span>/three/four<nowiki>|1|2 }}</nowiki></code> → '''{{#titleparts: one/two/three/four|1|2 }}'''

如果需要小写，使用lc:函数以控制输出：

: <code><nowiki>{{lc: {{#titleparts:</nowiki> <span style="color: blue;">one</span>/two/three/four<nowiki>|1|1 }} }}</nowiki></code> → '''{{lc: {{#titleparts:one/two/three/four|1|1 }}}}'''

你可以在字符串开头添加一个“伪”斜杠以修正第一个子字符串的大小写。对于''要返回的第一个分段''，应使用<code>2</code>而不是<code>1</code>。

: <code><nowiki>{{#titleparts:</nowiki> '''/'''<span style="color: blue;">one</span>/two/three/four<nowiki>|1|</nowiki>'''<u>2</u>'''<nowiki> }}</nowiki></code> → '''{{#titleparts: /one/two/three/four|1|2 }}'''
: <code><nowiki>{{#titleparts:</nowiki> '''/'''<span style="color: blue;">One</span>/two/three/four<nowiki>|1|</nowiki>'''<u>2</u>'''<nowiki> }}</nowiki></code> → '''{{#titleparts: /One/two/three/four|1|2 }}'''
}}

{{Warning|1=
一些字符{{ll|Manual:Page title#Naming restrictions|在页面标题中是非法的}}，会导致#titleparts不去解析字符串。

: <code><nowiki>{{#titleparts: {one/two} | 1 | 1 }}</nowiki></code> → '''{{#titleparts: {one/two} | 1 | 1 }}'''. 不产生预期的： '''{one'''
: <code><nowiki>{{#titleparts: [[page]]/123 | 1 | 2 }}</nowiki></code> → '''{{#titleparts: [[page]]/123 | 1 | 2 }}'''. 不起作用，因为页面标题中的中括号是非法的，并且此解析器函数不处理嵌入在其输入的「页面名称」参数中的链接，即使使用了MediaWiki语法或任何其他HTML或MediaWiki标签。
: <code><nowiki>{{#titleparts: red/#00FF00/blue | 1 | 3 }}</nowiki></code> → "{{#titleparts:  red/#00FF00/blue| 1 | 3 }}". 不起作用，因为“#”在页面标题中是非法的。
}}

{{Warning|1=
如果标题中的某个部分只是“<code>.</code>”或“<code>..</code>”，那么#titleparts不会解析字符串：

: <code><nowiki>{{#titleparts: one/./three | 1 | 1 }}</nowiki></code> → '''{{#titleparts: one/./three | 1 | 1 }}'''. 返回整个字符串。不产生预期的： '''one'''
}}

{{Warning|1=
如果输入超过255个UTF-8字节，则此函数不会正常降级（degrade gracefully）。如果输入字符串为256字节或更多，则返回整个字符串。
}}


<span id="String_functions"></span>
== 字符串函数 ==
{{Main|Extension:ParserFunctions/String functions}}

如果將<code>$wgPFEnableStringFunctions </code>設定為{{phpi|true}}，解析器函数的扩展會選擇性定義各種字串函式：

* <code>#len</code>
* <code>#pos</code>
* <code>#rpos</code>
* <code>#sub</code>
* <code>#count</code>
* <code>#replace</code>
* <code>#explode</code>
* <code>#urldecode</code>

請參閱專屬子頁的說明文件，以及{{ll|Manual:Performing string operations with parser functions}}的範例。

{{Warning
|1=<span lang="en" dir="ltr" class="mw-content-ltr">In 2013, it was decided that '''these functions will ''never'' be enabled on any Wikimedia wiki''', because they are inefficient when used on a large scale (see [[phab:T8455]] for some history).</span> '''<span lang="en" dir="ltr" class="mw-content-ltr">These functions do NOT work on Wikimedia wikis!</span>'''<br/><br/><span lang="en" dir="ltr" class="mw-content-ltr">If you are here to write something on a Wikimedia project, you are looking for something else: if your home wiki has string functions, it probably uses {{ll|Extension:Scribunto|Lua}}.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, the English Wikipedia uses [[w:Module:String|Module:String]], which does some of the same things with wildly different syntax.</span> <span lang="en" dir="ltr" class="mw-content-ltr">There are also individual [[w:Template:String-handling templates|String-handling templates]].</span>
}}

以下是[[Module:String]]函数的简要概述：

* [[w:Module:String#len|&#35;len]] （字符串长度）: <code><nowiki>{{</nowiki>[[:w:Wikipedia:Lua|#invoke]]<nowiki>:String|len|target_string}}</nowiki></code>
* [[w:Module:String#sub|&#35;sub]] （子字符串）: <code><nowiki>{{#invoke:String|sub|target_string|start_index|end_index}}</nowiki></code>
* [[w:Module:String#match|&#35;match]]: <code><nowiki>{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}</nowiki></code>
* [[w:Module:String#pos|&#35;pos]] （目标位置）: <code><nowiki>{{#invoke:String|pos|target_string|index_value}}</nowiki></code>
* [[w:Module:String#find|&#35;find]]: <code><nowiki>{{#invoke:String|find|source_string|target_string|start_index|plain_flag}}</nowiki></code>
* [[w:Module:String#replace (gsub)|&#35;replace]]: <code><nowiki>{{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}</nowiki></code>
* [[w:Module:String#rep|&#35;rep]] （重复）: <code><nowiki>{{#invoke:String|rep|source|count}}</nowiki></code>
* [[w:Module:String#escapePattern|&#35;escapePattern]]: <code><nowiki>{{#invoke:String|escapePattern|pattern_string}}</nowiki></code>
* [[w:Module:String#count|&#35;count]]: <code><nowiki>{{#invoke:String|count|source_str|pattern_string|plain_flag}}</nowiki></code>
* [[w:Module:String#join|&#35;join]]: <code><nowiki>{{#invoke:String|join|separator|string1|string2|...}}</nowiki></code>

<span id="General_points"></span>
== 一般帮助 ==

<span id="Substitution"></span>
=== 替换引用 ===

在井号前面添加<code>'''subst:'''</code>可以将字符串函数[[Special:MyLanguage/Help:Substitution|替换引用]]：

:<code><nowiki>{{subst:#ifexist:</nowiki> {{FULLPAGENAME}} <nowiki>| [[</nowiki>{{FULLPAGENAME}}<nowiki>]] | </nowiki>{{FULLPAGENAME}}<nowiki> }}</nowiki></code> → 将在文本中插入代码'''<code><nowiki>[[</nowiki>{{FULLPAGENAME}}<nowiki>]]</nowiki></code>'''，因为{{FULLPAGENAME}}存在。

{{Warning|1=
如果表单时包含''未''替换引用的可变代码，例如{{ll|Help:Magic words#Variables|变量}}或者其他解析器函数，那么被替换引用的解析器函数的结果是未定义的。为使结果恒定，需要运算的表达式中的所有易变代码都必须被替换引用。参见[[w:zh:Help:替换引用|帮助:替换引用]]。}}

{{ll|Extension:Cite#Substitution and embedded parser functions|{{tag|ref|open}}&hellip;{{tag|ref|close}} }}内的替换引用不起作用，如要使用，可以使用<code>{{((}}subst:#tag:ref{{!}}</code>&hellip;<code>{{))}}</code>。

<span id="Redirects"></span>
=== 重定向 ===

特别地，[[#.23time|<nowiki>{{</nowiki><code>#time:</code>&hellip;|<code>now-</code>&hellip;<nowiki>}}</nowiki>]]可以方便地重定向到包含日期的页面，但这不起作用。

<span id="Escaping_pipe_characters"></span>
=== 转义管道符 ===

<div lang="en" dir="ltr" class="mw-content-ltr">
==== In tables ====
</div>
解析器函数会破坏{{ll|Help:Tables|wikitable}}语法和管道字符（<code><nowiki>|</nowiki></code>），将所有的原始管道字符视为参数分隔符。
为了避免这个，很多wiki使用模板[[{{ns:10}}:!]]，其内容仅为一个管道符（<code><nowiki>|</nowiki></code>），自MediaWiki 1.24开始被{{ll|Help:Magic words#Other|<code><nowiki>{{!}}</nowiki></code> 魔术字}}取代。
这会从MediaWiki解析器中“隐藏”管道符号，确保在展开页面上的所有模板和变量之前不考虑它。
然后将被解释为表格的行或列分隔符。
你也可以使用原始的HTML表格语法，尽管这并不直观而且容易出错。

您也可以使用HTML實體：<code>&amp;#124;</code>或<code>&amp;vert;</code>將管道字符&vert;轉換為纯粹、未解析的字元來顯示。

{| class="wikitable"
! 说明
! 您输入的
! 您输出的
|-
| 将管道字符转义为表格行/列分隔符
| <pre>
{{!}}
</pre>
| style="text-align:center;" | &#124;
|-
| 将管道字符转义为纯字符
| <pre>
&amp;#124;
</pre>
| style="text-align:center;" | &#124;
|}

<div lang="en" dir="ltr" class="mw-content-ltr">
==== In template calls ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The same pipe protection applies as for the following example:
</div>
<pre><nowiki>{{Documentation|content=
... text before ...<code>subpage-name=sandbox3</code> is equivalent to <code>sandbox link=../sandbox3 | sandbox name=sandbox3</code>.
... text after ...
}}</nowiki></pre>
<span lang="en" dir="ltr" class="mw-content-ltr">We observe that ''text after'' is not displayed when the pipe | just before ''sandbox name='' is present since ''|sandbox name='' is considered erroneously to be a parameter of template ''Documentation'' at the same level as ''|content='' is.</span>

<span id="Stripping_whitespace"></span>
=== 除去空白字符 ===

空白字符（whitespace），包括换行符、制表符和空格，在这些解析器函数的所有参数的开头和结尾处，都会被除去。如果不希望这样，可以将字符串放在引号中后进行比较。

:<code><nowiki>{{#ifeq: foo&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;foo | equal | not equal }}</nowiki></code> → '''{{#ifeq: foo            |            foo | equal | not equal }}'''
:<code><nowiki>{{#ifeq: "foo&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;" | "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;foo" | equal | not equal }}</nowiki></code> → '''{{#ifeq: "foo           " | "           foo" | equal | not equal }}'''

要避免修整then和else部分，参见[[m:Template:If]]。一些人为达到目的，会使用<nowiki>&lt;</nowiki>{{ll|Wiki markup#Nowiki|nowiki}}<nowiki>&gt;</nowiki> <nowiki>&lt;</nowiki>/nowiki<nowiki>&gt;</nowiki>而非空格。

:<syntaxhighlight lang="wikitext" inline>foo{{#if:|| bar }}foo</syntaxhighlight> → '''foo{{#if:|| bar }}foo'''
:<syntaxhighlight lang="xml" inline>foo{{#if:||<nowiki /> bar <nowiki />}}foo</syntaxhighlight> → '''foo{{#if:||<nowiki /> bar <nowiki />}}foo'''

然而，这种方法只能用于渲染'''单个'''空白字符，因为解析器函数会将一行中的多个空白字符挤压成一个。

:{|
|<syntaxhighlight lang="html"><span style="white-space: pre;">foo{{#if:||<nowiki/>      bar      <nowiki/>}}foo</span></syntaxhighlight>|| → ||'''<span style="white-space: pre;">foo{{#if:||<nowiki/>      bar      <nowiki/>}}foo</span>'''
|}

在本例中，<code>white-space: pre</code>样式用来强制浏览器保留空白，但即使使用它，也不会显示空格。发生这种情况是因为这些空格在发送到浏览器之前，就已经被软件除去了。

要解决此问题，可以将空白字符替换为<code>&amp;#32;</code>（''可折行空格''）或者<code>&amp;nbsp;</code>（''不可折行空格''），因为这些字符不会被软件修改：

:<syntaxhighlight lang="html" inline><span style="white-space: pre;">foo{{#if:||&#32;&#32;&#32;bar&#32;&#32;&#32;}}foo</span></syntaxhighlight> → '''<span style="white-space: pre;">foo{{#if:||&#32;&#32;&#32;bar&#32;&#32;&#32;}}foo</span>'''
:<syntaxhighlight lang="html" inline>foo{{#if:||&nbsp;&nbsp;&nbsp;bar&nbsp;&nbsp;&nbsp;}}foo</syntaxhighlight> → '''foo{{#if:||&nbsp;&nbsp;&nbsp;bar&nbsp;&nbsp;&nbsp;}}foo'''

请注意，并非所有参数都是平等的。
在解析器函数中，开头和结尾的空格始终是忽略的。
在{{ll|Help:Templates|模板}}中，命名参数和添加数字的非命名参数的开头和结尾的空格是被忽略的，但非命名参数的首尾空格不会被忽略：

:<code>foo{{tlx|1x|content{{=}} bar }}foo</code> → '''foo{{1x|content= bar }}foo'''
:<code>foo{{tlx|1x|1{{=}} bar }}foo</code> → '''foo{{1x|1= bar }}foo'''
:<code>foo{{tlx|1x|&nbsp;bar&nbsp;}}foo</code> → '''foo{{1x| bar }}foo'''

<div lang="en" dir="ltr" class="mw-content-ltr">
== Other parser functions ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Case conversion functions ===
</div>
* <span lang="en" dir="ltr" class="mw-content-ltr">'''Lowercase:'''</span> {{xpdoc|lc: AbC|}}
* <span lang="en" dir="ltr" class="mw-content-ltr">'''Uppercase:'''</span> {{xpdoc|uc: AbC|}}
* <span lang="en" dir="ltr" class="mw-content-ltr">'''Lowercase first character:'''</span> {{xpdoc|lcfirst: AbC}}
* <span lang="en" dir="ltr" class="mw-content-ltr">'''Uppercase first character:'''</span> {{xpdoc|ucfirst: abc}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Encoding functions ===
</div>
* <span lang="en" dir="ltr" class="mw-content-ltr">'''URL encoding:'''</span>
<syntaxhighlight lang="wikitext">
"{{urlencode: AbC
dEf ghi}}"
</syntaxhighlight>
<span lang="en" dir="ltr" class="mw-content-ltr">renders as</span>
----
"{{urlencode: AbC
dEf ghi}}"
----
<span lang="en" dir="ltr" class="mw-content-ltr">So inner new lines convert into %0A, and inner spaces convert into +.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Anchor encoding ===
</div>
<syntaxhighlight lang="wikitext">
{{anchorencode: AbC dEf ghi}}
</syntaxhighlight>
<span lang="en" dir="ltr" class="mw-content-ltr">renders as</span>
---- 
{{anchorencode: AbC dEf ghi}}
----

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Padding functions ===
</div>
* {{xpdop3p3c|d="|padleft: bc d |8|||a}}
* {{xpdop3p3c|d="|padright: bc d |8|||a}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Formatting functions ===
</div>
* {{xpd0|d="|formatnum: 1234567890}}

<span id="See_also"></span>
== 參見 ==
* {{ll|Help:Parser functions in templates}}
* {{ll|Parser extension tags}}
* {{ll|Parser function hooks}} - 自带的和扩展添加的解析器函数的（不完整）列表。
* {{ll|Manual:Newlines and spaces}}
* {{ll|Manual:Converting between ParserFunctions syntax and TeX syntax}}
* {{ll|Help:Magic words}}
* [[Module:String]]已废弃的{{ll|Extension:StringFunctions}}
* {{ll|Extension:PhpTags}}
* Wikibase的解析器函数（启用Wikidata的扩展）： [[d:Special:MyLanguage/Wikidata:How to use data on Wikimedia projects#Parser function|<span lang="en" dir="ltr" class="mw-content-ltr">How to use data on Wikimedia projects#Parser function</span>]]

<span id="References"></span>
== 參考資料 ==
<references />
{{Parser functions nav}}

[[Category:Extension help{{#translation:}}|ParserFunctions]]
[[Category:Magic words{{#translation:}}]]