Help:Extension:ParserFunctions

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This page is a translated version of the page Help:Extension:ParserFunctions and the translation is 88% complete.

Outdated translations are marked like this.

ParserFunctions 拡張かくちょう機能きのうは MediaWiki の既存きそんの「マジックワード」を補完ほかんする11のパーサ関数かんすうを提供ていきょうします。 (文字もじ列れつ処理しょりのために追加ついかのパーサー関数かんすうを提供ていきょうするように設定せっていできるかもしれません。ここでいう文字もじ列れつ関数かんすうの説明せつめい文書ぶんしょはこちらを参照さんしょうしてください。) この拡張かくちょう機能きのうが提供ていきょうするすべてのパーサー関数かんすうは以下いかの形式けいしきです:

{{#関数かんすう名めい: 引数ひきすう 1 | 引数ひきすう 2 | 引数ひきすう 3 ... }}

注意ちゅうい: このページを編集へんしゅうすると、編集へんしゅう内容ないようが CC0 のもとで公開こうかいされることに同意どういしたと見みなされます。詳細しょうさいはパブリック・ドメインのヘルプページを参照さんしょうしてください。

#expr

種類しゅるい	演算えんざん子こ
グループ化か (括弧かっこ)	`( )`
数値すうち	`1234.5` `e` (2.718) `pi` (3.142)
	二に項こう演算えんざん子こ `e` 単項たんこう `+`,`-`
単項たんこう	`not ceil trunc floor abs exp ln sin cos tan acos asin atan`
二に項こう	`^`
	`* / div mod`
	`+ -`
四捨五入ししゃごにゅう	`round`
論理ろんり	`= != <> > < >= <=`
	`and`
	`or`

この関数かんすうは、数式すうしきを計算けいさんしてその計算けいさん結果けっかを返かえします。この関数かんすうはmw.ext.ParserFunctions.expr 関数かんすうを介かいして Scribunto でも使つかえます。

{{#expr: 数式すうしき }}

Basic example

{{#expr: 1 + 1 }} → 2

表ひょうの右みぎ欄らんは使用しようできる演算えんざん子こで、上うえほど優先ゆうせん順位じゅんいが高たかいものです。各かく演算えんざん子この機能きのうの詳細しょうさいは計算けいさんのヘルプヘルプ:Calculation を参照さんしょうしてください。出力しゅつりょく結果けっかの精度せいどと形式けいしきには幅はばがあり、ウィキを実行じっこうするサーバーのOSバージョン、サイト表示ひょうじ言語げんごの数値すうち形式けいしきの影響えいきょうを受うけます。

ブール代数だいすうを使用しようして評価ひょうかする際さい、値ねがゼロなら false、非ひゼロなら正せいの数かずでも負まけの数かずでも true と評価ひょうかされます:

{{#expr: 1 and -1 }} → 1

{{#expr: 1 and 0 }} → 0

{{#expr: 1 or -1 }} → 1

{{#expr: -1 or 0 }} → 1

{{#expr: 0 or 0 }} → 0

空そらの入力にゅうりょく式しきは空そらの文字もじ列れつを返かえします。無効むこうな式しきはいくつかのエラーメッセージのうちのいずれかを返かえします。このエラーは #iferror 関数かんすうを使用しようして捕捉ほそくできます:

{{#expr: }} →

{{#expr: 1+ }} → Expression error: Missing operand for +.

{{#expr: 1 = }} → Expression error: Missing operand for =.

{{#expr: 1 foo 2 }} → Expression error: Unrecognized word "foo".

数値すうちの前後ぜんごの加算かさんおよび減算げんざんオペランドの順序じゅんじょは意味いみがあり、誤あやまった入力にゅうりょくを持もつオペランドとしてではなく、正ただしまたは負まけの値ねとして扱あつかわれる場合ばあいがあります。

{{#expr: +1 }} → 1

{{#expr: -1 }} → -1

{{#expr: + 1 }} → 1

{{#expr: - 1 }} → -1

メモ: マジックワードの出力しゅつりょくを使用しようする場合ばあいは、コンマを削除さくじょして数字すうじを翻訳ほんやくするために、それらをraw形式けいしきにする必要ひつようがあることに注意ちゅういしてください。たとえば、{{NUMBEROFUSERS}} は 17,929,365 になりますが、17929365 が必要ひつようです。これは {{formatnum :{{NUMBEROFUSERS}}|R}} を使用しようして取得しゅとくできます。これは、数字すうじが翻訳ほんやくされる一部いちぶの言語げんごでは特とくに重要じゅうようです。たとえば、ベンガル語ごでは、{{NUMBEROFUSERS}} は ৩০,০৬১ を生成せいせいします。

{{#expr:{{NUMBEROFUSERS}}+100}} → Expression error: Unrecognized punctuation character ",".

{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}} → 17929465

警告けいこく:

演算えんざん子こ mod は、第だい 2 引数ひきすうの値ねによっては誤あやまった結果けっかを返かえす場合ばあいがあります:

{{#expr: 123 mod (2^64-1)}} → Division by zero. (空そらの文字もじ列れつを返かえしますが、123 を返かえすべきです)

日付ひづけに基もとづいて計算けいさんを行おこなう場合ばあい(たとえば、現在げんざいの日付ひづけと時刻じこくが他たの日付ひづけと時刻じこくより後のちかどうかをテストする場合ばあい)、最初さいしょに{{#time: xNU }}を使用しようして時刻じこくを1970年ねん1月がつ1日にち以降いこうの秒びょう数すうに変換へんかんし、次つぎに単純たんじゅんに加算かさんして日付ひづけを数値すうちとして減算げんざんします。

四捨五入ししゃごにゅう機能きのう

左側ひだりがわの数字すうじを四捨五入ししゃごにゅうして 1/10 の倍数ばいすうに切きり上あげ、べき指数しすうは右側みぎがわに与あたえられた数かずの小数点しょうすうてん2ケタ目め以下いかを切きり上あげた値ねに等ひとしくなります。

切きり上あげや切きり捨すてを行おこなうには、それぞれ単項たんこうのceilとfloorを使用しようしてください。

テストケース結果けっか四捨五入ししゃごにゅうの手法しゅほう

{{#expr: 1/3 round 5 }} 0.33333 最終さいしゅう桁けたが 5 未満みまんであるため、切きり上あげはされません (0.333333… → 0.33333)

{{#expr: 1/6 round 5 }} 0.16667 最終さいしゅう桁けたが 5 以上いじょうであるため、切きり上あげされます (0.166666… → 0.16667)

{{#expr: 8.99999/9 round 5 }} 1 この場合ばあいも、結果けっかは最後さいごの桁けたで切きり上あげられ、追加ついかの切きり上あげが行おこなわれます。 (0.999998… → 1.00000 → 1)

{{#expr: 1234.5678 round -2 }} 1200 負まけの値ねは小数点しょうすうてんの左側ひだりがわに丸まるめられるため、100に最もっとも近ちかい値ねに丸まるめられます。

{{#expr: 1234.5678 round 2 }} 1234.57 正せいの値ねは小数点しょうすうてんの右側みぎがわに丸まるめられるため、最もっとも近ちかい100番目ばんめに丸まるめられます

{{#expr: 1234.5678 round 2.3 }} 1234.57 round の右みぎの値ねの小数点しょうすうてん以下いかは、丸まるめの結果けっかには影響えいきょうしません

{{#expr: trunc 1234.5678 }} 1234 小数点しょうすうてん以下いかの切きり捨すて

最もっとも近ちかい整数せいすうへの丸まるめ

{{#expr: 1/3 round 0 }} 0 最もっとも近ちかい整数せいすうへの切きり捨すてで 0

{{#expr: 1/2 round 0 }} 1 最もっとも近ちかい整数せいすうへの切きり上あげで 1

{{#expr: 3/4 round 0 }} 1 最もっとも近ちかい整数せいすうへの切きり上あげで 1

{{#expr: -1/3 round 0 }} -0 最もっとも近ちかい整数せいすうへの切きり上あげで 0

{{#expr: -1/2 round 0 }} -1 最もっとも近ちかい整数せいすうへの切きり捨すてで -1

{{#expr: -3/4 round 0 }} -1 最もっとも近ちかい整数せいすうへの切きり捨すてで -1

ceill や floor による切きり上あげや切きり捨すて

{{#expr: ceil(1/3) }} 1 次つぎに大おおきい整数せいすうまで

{{#expr: floor(1/3) }} 0 次つぎの「小ちいさい」整数せいすう、つまりゼロまで

{{#expr: ceil(-1/3) }} -0 最もっとも近ちかい整数せいすうへの切きり上あげで 0

{{#expr: floor(-1/3) }} -1 負まけの整数せいすうである次つぎの小ちいさい整数せいすうまで

{{#expr: ceil 1/3 }}

0.33333333333333

1が既すでに整数せいすうであるため、丸まるめは行おこなわれません

警告けいこく:

あなたの予想よそうとは異ことなり、ceil(1/3)ではなく(ceil 1)/3と解釈かいしゃくされる

文字もじ列れつ

式しきは数値すうちのような値ねでのみ機能きのうし、文字もじ列れつや文字もじを比較ひかくすることはできません。代かわりに#ifeqを使用しようできます。

{{#expr: "a" = "a" }} → Expression error: Unrecognized punctuation character """.

{{#expr: a = a }} → Expression error: Unrecognized word "a".

{{#ifeq: a | a | 1 | 0 }} → 1

#if

この関数かんすうはテスト文字もじ列れつを評価ひょうかし、それが空そらであるかどうかを判定はんていします。空白くうはくのみを含ふくむテスト文字もじ列れつは空そらであると見み做されます。

{{#if: テスト文字もじ列れつ | テスト文字もじ列れつが空そらではない場合ばあいの値ね | テスト文字もじ列れつが空そら (または空白くうはくのみ) の場合ばあいの値ね}}

{{#if: パラメーター 1 | パラメーター 2 | パラメーター 3 }}

この関数かんすうは、初はじめに最初さいしょの引数ひきすうが空そらでないか確たしかめます。最初さいしょの引数ひきすうが空そらでない場合ばあい、2 番目ばんめの引数ひきすうを表示ひょうじします。最初さいしょの引数ひきすうが空むなしまたは空白くうはく文字もじ（空白くうはく、改行かいぎょう等とう）のみを含ふくむ場合ばあい、3 番目ばんめの引数ひきすうを表示ひょうじします。

{{#if: | yes | no}} → no

{{#if: string | yes | no}} → yes

{{#if:      | yes | no}} → no

{{#if: | yes | no}} → no

テスト文字もじ列れつは常つねに純粋じゅんすいなテキストとして評価ひょうかされます。そのため数式すうしきは評価ひょうかされません (#ifexpr を参照さんしょう):

{{#if: 1==2 | yes | no }} → yes

{{#if: 0 | yes | no }} → yes

最後さいごの引数ひきすう (false) は省略しょうりゃく可能かのうです:

{{#if: foo | yes }} → yes

{{#if: | yes }} →

{{#if: foo | | no}} →

関数かんすうはネストできます。これを行おこなうには、囲かこんでいる #if 関数かんすうのパラメーターの代かわりに、内部ないぶの #if 関数かんすうを完全かんぜんな形式けいしきでネストします。ウィキやメモリ制限せいげんによって異ことなりますが、最大さいだい7レベルのネストが可能かのうです。

{{#if:テスト文字もじ列れつ
|テスト文字もじ列れつが空そらではない場合ばあいの値ね
|{{#if:テスト文字もじ列れつ
  |テスト文字もじ列れつが空そらではない場合ばあいの値ね
  |テスト文字もじ列れつが空そら (または空白くうはくのみ) の場合ばあいの値ね
  }}
}}

テスト文字もじ列れつが空そらではない場合ばあいの値ね

#if 文ぶんにおいて引数ひきすうをテスト文字もじ列れつとして用もちいることも可能かのうです。変数へんすう名めいの後のちには |（パイプ記号きごう）を追加ついかする必要ひつようがあります。 (そのため、パラメーターに値ねがない場合ばあいは、文字もじ列れつ "{{{1}}}"ではなく空そらの文字もじ列れつに評価ひょうかされます。)

{{#if:{{{1|}}}|変数へんすう1にテキストを入力にゅうりょくしました|変数へんすう1にテキストがありません}}

このパーサー関数かんすうの他ほかの例れいについては Help:テンプレート内ないでのパーサー関数かんすうを参照さんしょうしてください。

#ifeq

このパーサー関数かんすうは、2つの入力にゅうりょく文字もじ列れつを比較ひかくし、それらが同一どういつであるかどうかを判断はんだんし、結果けっかに基もとづいて2つの文字もじ列れつのうちの1つを返かえします。さらに比較ひかくと出力しゅつりょく文字もじ列れつが必要ひつような場合ばあいは、#switchの使用しようを検討けんとうしてください。

{{#ifeq: string 1 | string 2 | value if identical | value if different }}

両方りょうほうの文字もじ列れつが有効ゆうこうな数値すうちである場合ばあい、文字もじ列れつは数値すうち的てきに比較ひかくされます。

{{#ifeq: 01 | 1 | equal | not equal}} → equal

{{#ifeq: 0 | -0 | equal | not equal}} → equal

{{#ifeq: 1e3 | 1000 | equal | not equal}} → equal

{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}} → equal

それ以外いがいは文字もじ列れつとして比較ひかくします。その場合ばあいは大文字おおもじ小文字こもじを識別しきべつします。

{{#ifeq: foo | bar | equal | not equal}} → not equal

{{#ifeq: foo | Foo | equal | not equal}} → not equal

{{#ifeq: "01" | "1" | equal | not equal}} → not equal (引用いんよう符ふなしで、上記じょうきの同様どうようの例れいと比較ひかくしてください)

{{#ifeq: 10^3 | 1000 | equal | not equal}} → not equal (前述ぜんじゅつした同様どうようの例れいと対比たいひしてみるには、#expr は有効ゆうこうな特定とくていの数値すうちを先さきに返かえします)

実用じつよう的てきな例れいとして、既存きそんのテンプレート Template:Timer をパーサーを使用しようして、短みじかい時間じかんと長ながい時間じかんの2つの標準時ひょうじゅんじ間あいだから選択せんたくするとします。文字もじ列れつ「short」と比較ひかくする最初さいしょの入力にゅうりょくとしてパラメータを取とります–順序じゅんじょの規則きそくはありませんが、パラメーターが最初さいしょにある方ほうが読よみやすくなります。テンプレートコードは次つぎのように定義ていぎされています:

{{#ifeq: {{{1|}}} | short | 20 | 40 }}

次つぎのようになります:

{{timer|short}} → 20

{{timer|20}} → 40

{{timer}} → 40

警告けいこく:

パーサー関数かんすう内ないで使用しようする場合ばあい、パーサータグおよびその他たのパーサー関数かんすうは一時いちじ的てきに一意いちいのコードに置おき換かえる必要ひつようがあります。これは比較ひかくに影響えいきょうします:

{{#ifeq: <nowiki>foo</nowiki> | <nowiki>foo</nowiki> | equal | not equal}} → not equal

{{#ifeq: <math>foo</math> | <math>foo</math> | equal | not equal}} → not equal

{{#ifeq: {{#tag:math|foo}} | {{#tag:math|foo}} | equal | not equal}} → not equal

{{#ifeq: [[foo]] | [[foo]] | equal | not equal}} → equal

比較ひかくするどの文字もじ列れつも、そのタグを含ふくむ同おなじテンプレートを呼よび出だす場合ばあいは真しん、そのタグを含ふくみ内容ないようが同おなじだが別々べつべつのテンプレートを呼よび出だす場合ばあいは偽にせ。

警告けいこく:

PAGENAMEマジックワードとの文字通もじどおりの比較ひかくは、サイトの構成こうせいによっては失敗しっぱいする場合ばあいがあります。たとえば、ウィキによっては、{{FULLPAGENAME}}が最初さいしょの文字もじを大文字おおもじにし、すべてのアンダースコアをスペースに置おき換かえる場合ばあいがあります。

これを回避かいひするには、両方りょうほうのパラメーターにマジックワードを適用てきようします。

{{#ifeq: {{FULLPAGENAME: L'Aquila}} | {{FULLPAGENAME}} | equal | not equal}} → equal

#iferror

この関数かんすうは入力にゅうりょく文字もじ列れつを取とり、2つの結果けっかから1つを返かえします。この関数かんすうは、 #expr や #time や #rel2abs のような他ほかのパーサー関数かんすう、ループや再帰さいきのようなテンプレートエラー、その他たの「フェースソフト」なパーサーエラーによって作つくられた class="error" を含ふくむ HTML オブジェクトが入力にゅうりょく文字もじ列れつに含ふくまれていた場合ばあいに true と評価ひょうかします。

{{#iferror: test string | value if error | value if correct }}

返かえし値ちの文字もじ列れつの一方いっぽうまたは両方りょうほうが省略しょうりゃくできます。もし correct の文字もじ列れつが省略しょうりゃくされていた場合ばあい、エラーがないのであれば test string が返かえされます。 error の文字もじ列れつも省略しょうりゃくされていた場合ばあいは、エラー時じにから文字もじ列れつが返かえされます。

{{#iferror: {{#expr: 1 + 2 }} | error | correct }} → correct

{{#iferror: {{#expr: 1 + X }} | error | correct }} → error

{{#iferror: {{#expr: 1 + 2 }} | error }} → 3

{{#iferror: {{#expr: 1 + X }} | error }} → error

{{#iferror: {{#expr: 1 + 2 }} }} → 3

{{#iferror: {{#expr: 1 + X }} }} → ‌

{{#iferror: {{#expr: . }} | error | correct }} → correct

{{#iferror: <strong class="error">a</strong> | error | correct }} → error

エラーによっては追跡ついせきカテゴリを生しょうじさせ、{{#iferror:}} を当あてても同どうカテゴリの追加ついかを回避かいひできません。

#ifexpr

この関数かんすうは数式すうしきを評価ひょうかし、結果けっかの真偽しんぎ値ちに応おうじて2つの文字もじ列れつのいずれかを返かえします:

{{#ifexpr: expression | value if true | value if false }}

expression 入力にゅうりょくは、上記じょうきの#exprとまったく同おなじように評価ひょうかされ、同おなじ演算えんざん子こを使用しようできます。次つぎに、出力しゅつりょくは真偽しんぎ値ちの式しきとして評価ひょうかされます。

空そらの入力にゅうりょく式しきはfalseと評価ひょうかされます:

{{#ifexpr: | yes | no}} → no

上記じょうきのように、ゼロはfalseと評価ひょうかされ、ゼロ以外いがいの値ねはtrueと評価ひょうかされるため、この関数かんすうは#ifeqと#exprのみを使用しようする関数かんすうと同等どうとうです:

{{#ifeq: {{#expr: expression }} | 0 | value if false | value if true }}

空そらの入力にゅうりょく式しきまたは間あいだ違ちがった入力にゅうりょく式しきを除のぞきます(エラーメッセージは空そらの文字もじ列れつとして扱あつかわれます。ゼロに等ひとしくないため、value if true を取得しゅとくします)。

{{#ifexpr: = | yes | no }} → Expression error: Unexpected = operator.

比較ひかく

{{#ifeq: {{#expr: = }} | 0 | no | yes }} → yes

戻もどり値ちのいずれかまたは両方りょうほうを省略しょうりゃくできます。適切てきせつなブランチが空そらのままの場合ばあい、出力しゅつりょくは提供ていきょうされません。

{{#ifexpr: 1 > 0 | yes }} → yes

{{#ifexpr: 1 < 0 | yes }} →

{{#ifexpr: 0 = 0 | yes }} → yes

{{#ifexpr: 1 > 0 | | no}} →

{{#ifexpr: 1 < 0 | | no}} → no

{{#ifexpr: 1 > 0 }} →

等号とうごうまたは不等号ふとうごうのブール演算えんざん子こに対応たいおうします。

{{#ifexpr: 0 = 0 or 1 = 0 | yes}} → yes

{{#ifexpr: 0 = 0 and 1 = 0 | | no}} → no

{{#ifexpr: 2 > 0 or 1 < 0 | yes}} → yes

{{#ifexpr: 2 > 0 and 1 > 0 | yes | no}} → yes

警告けいこく:

#ifexprによる数値すうち比較ひかくの結果けっかは、#ifeqや#switchの結果けっかと必かならずしも一致いっちしません。これらの後者こうしゃの2つは、#ifexprよりも正確せいかくであり、同等どうとうの結果けっかを返かえしません。

変更へんこうされた最後さいごの桁けたとのこれらの比較ひかくを検討けんとうしてください:

{{#ifeq: 12345678901234567 | 12345678901234568 | equal | not equal}} → not equal

{{#switch: 12345678901234567 | 12345678901234568 = equal | not equal}} → not equal

#ifeqと#switchで使用しようされるPHPは、整数せいすう型がたの2つの数値すうちを比較ひかくするため、期待きたいされる結果けっかを正ただしく返かえします。一方いっぽう、#ifexprと同おなじ番号ばんごうの場合ばあい：

{{#ifexpr: 12345678901234567 = 12345678901234568 | equal | not equal}} → equal

数字すうじが異ことなると、equalの結果けっかは実際じっさいには正まさしくありません。

#ifexprでのこの動作どうさは、MediaWikiが式しきのリテラル数すうをfloat(フロート)型がたに変換へんかんするために発生はっせいします。これは、このような大おおきな整数せいすうの場合ばあい、丸まるめを伴ともないます。

#ifexist

この関数かんすうは入力にゅうりょく文字もじ列れつを受うけ取とり、それをページタイトルとして解釈かいしゃくし、そのページがローカルウィキに存在そんざいするかどうかに応おうじて、2つの値ねのいずれかを返かえします。

{{#ifexist: page title | value if exists | value if doesn't exist }}

ページが存在そんざいする場合ばあい、コンテンツが含ふくまれているかどうかにかかわらず、関数かんすうはtrue(真しん)と評価ひょうかされます(カテゴリリンクやマジックワードなどのメタデータが含ふくまれていますが、表示ひょうじされていません)。コンテンツ、空白くうはく、またはリダイレクトです。存在そんざいしていないページのみがfalse(偽にせ)と評価ひょうかされます。これには、ページが以前いぜんは存在そんざいしていたが削除さくじょされた場合ばあいも含ふくまれます。

{{#ifexist: Help:Extension:ParserFunctions/ja | exists | doesn't exist }} → exists

{{#ifexist: XXHelp:Extension:ParserFunctions/jaXX | exists | doesn't exist }} → doesn't exist

この関数かんすうは、カスタマイズされたシステムメッセージと、ソフトウェアによって定義ていぎされた特別とくべつページに対たいしてtrue(真しん)と評価ひょうかされます。

{{#ifexist: Special:Watchlist | exists | doesn't exist }} → exists

{{#ifexist: Special:CheckUser | exists | doesn't exist }} → exists (Checkuser拡張かくちょう機能きのうがこのウィキにインストールされているため)

{{#ifexist: MediaWiki:Copyright | exists | doesn't exist }} → exists (MediaWiki:Copyrightがカスタマイズされているため)

ページが#ifexist:を使用しようしてターゲットをチェックする場合ばあい、そのページはターゲットページのSpecial:WhatLinksHereリストに表示ひょうじされます。したがって、コード{{#ifexist:Foo }}がこのページ(Help:Extension:ParserFunctions/ja)にライブで含ふくまれている場合ばあい、Special:WhatLinksHere/FooはHelp:Extension:ParserFunctions/jaをリストします。

共有きょうゆうメディアリポジトリを使用しようするWikiでは、#ifexist:を使用しようして、ファイルがリポジトリにアップロードされているかどうかを確認かくにんできますが、Wiki自体じたいにはアップロードされていません。

{{#ifexist: File:Example.png | exists | doesn't exist }} → doesn't exist

{{#ifexist: Image:Example.png | exists | doesn't exist }} → doesn't exist

{{#ifexist: Media:Example.png | exists | doesn't exist }} → exists

ファイルのローカル説明せつめいページが作成さくせいされている場合ばあい、結果けっかは上記じょうきのすべてに対たいして existsになります。

#ifexist:はインターウィキリンクでは機能きのうしません。

ifexistの制限せいげん

#ifexist: は、「高こう負荷ふかなパーサー関数かんすう」と見みなされます。 1つのページに含ふくめることができるのは限かぎられた数かずだけです(参照さんしょう読よみ込こみされたテンプレート内ないの関数かんすうを含ふくむ)。この制限せいげんを超こえると、参照さんしょう読よみ込こみ先さきページが存在そんざいするかどうかに関係かんけいなく、それ以降いこうの #ifexist: 関数かんすうは自動的じどうてきにfalseを返かえし、ページは Category:Pages with too many expensive parser function calls に分類ぶんるいされます。 tracking category の名前なまえは、ウィキのコンテンツ言語げんごによって異ことなる場合ばあいがあります。

使用しよう事例じれいによっては、a.new (存在そんざいしないページへのリンクを選択せんたく) または a:not(.new) (存在そんざいするページへのリンクを選択せんたく) を使用しようして ifexist 効果こうかを css で代用だいようできます。さらに、単たん一いちページで使用しようするメモリ消耗しょうもうの激はげしいパーサ関数かんすうの件数けんすうの上限じょうげんは $wgExpensiveParserFunctionLimit で制御せいぎょされ、必要ひつような場合ばあいは上限じょうげん値ちを LocalSettings.php で変更へんこうできます。

存在そんざいし、必要ひつようなページ

存在そんざいせず、#ifexistを使つかっているかどうかテスト済ずみのページは、募集ぼしゅうページに分類ぶんるいされます。根拠こんきょはタスク T14019 に記述きじゅつがあり、回避かいひ策さくの詳細しょうさいは Template:Linkless を参照さんしょうしてください。（訳注やくちゅう：リンク元もとは削除さくじょ済ずみ）

#rel2abs

この関数かんすうは相対そうたいファイルパスを絶対ぜったいファイルパスに変換へんかんします。

{{#rel2abs: path }}

{{#rel2abs: path | base path }}

path 部分ぶぶんでは、以下いかの構文こうぶんを使用しようできます:

. → 現在げんざいの階層かいそう
.. → 1 つ上うえの階層かいそうに移動いどう
/foo → 下位かいディレクトリ /foo に 1 階層かいそう移動いどう

base path を指定していしていない場合ばあいは、ページの完全かんぜんなページ名めいが代かわりに使用しようされます:

{{#rel2abs: /quok | Help:Foo/bar/baz }} → Help:Foo/bar/baz/quok

{{#rel2abs: ./quok | Help:Foo/bar/baz }} → Help:Foo/bar/baz/quok

{{#rel2abs: ../quok | Help:Foo/bar/baz }} → Help:Foo/bar/quok

{{#rel2abs: ../. | Help:Foo/bar/baz }} → Help:Foo/bar

/. や /./ のような無効むこうな構文こうぶんは無視むしされます。連続れんぞくする終止符しゅうしふは2つまでしか許可きょかされていないため、次つぎのようなシーケンスを使用しようして、連続れんぞくするステートメントを区切くぎることができます。

{{#rel2abs: ../quok/. | Help:Foo/bar/baz }} → Help:Foo/bar/quok

{{#rel2abs: ../../quok | Help:Foo/bar/baz }} → Help:Foo/quok

{{#rel2abs: ../../../quok | Help:Foo/bar/baz }} → quok

{{#rel2abs: ../../../../quok | Help:Foo/bar/baz }} → Error: Invalid depth in path: "Help:Foo/bar/baz/../../../../quok" (tried to access a node above the root node).

For a similar group of functions see also Help:Magic words#URL data. Built-in parser functions include: 'localurl:', 'fullurl:', 'anchorencode:' etc.

#switch

関連かんれん項目こうもく: w:Help:Switch parser function

この関数かんすうは入力にゅうりょく値ち1件けんを複数ふくすうのテストケースと比較ひかくし、ヒットした場合ばあいは当該とうがいの文字もじ列れつを返かえします。

{{#switch: comparison string
 | case = result
 | case = result
 | ...
 | case = result
 | default result
}}

例れい:

{{#switch: baz | foo = Foo | baz = Baz | Bar }} → Baz

{{#switch: foo | foo = Foo | baz = Baz | Bar }} → Foo

{{#switch: zzz | foo = Foo | baz = Baz | Bar }} → Bar

#switch with partial transclusion tags can affect a configuration file that enables an editor unfamiliar with template coding to view and edit configurable elements.

既定きてい

case文字もじ列れつに対応たいおうするcomparison stringがヒットしない場合ばあい、default resultを返かえします。

{{#switch: test | foo = Foo | baz = Baz | Bar }} → Bar

この構文こうぶんでは、デフォルトの結果けっかは最後さいごのパラメーターである必要ひつようがあり、生せいの等号とうごう({{}}のない等号とうごう)を含ふくめることはできません。一致いっちする場合ばあいは、ケース比較ひかくとして扱あつかわれ、一致いっちするケースがない場合ばあいはテキストは表示ひょうじされません。これは、既定きてい値ちが定義ていぎされていない (空そらである) ためです。ただし、大文字おおもじと小文字こもじが一致いっちする場合ばあいは、関連かんれんする文字もじ列れつが返かえされます。

{{#switch: test | Bar | foo = Foo | baz = Baz }} →

{{#switch: test | foo = Foo | baz = Baz | B=ar }} →

{{#switch: test | test = Foo | baz = Baz | B=ar }} → Foo

代替だいたい方法ほうほうとして、既定きていの結果けっかを "#default" のcase文字もじ列れつで明示めいじ的てきに宣言せんげんすることもできます。

{{#switch: comparison string
 | case = result
 | case = result
 | ...
 | case = result
 | #default = default result
}}

この方法ほうほうで宣言せんげんされたデフォルトの結果けっかは、関数かんすう内ないのどこにでも配置はいちできます。

{{#switch: test | foo = Foo | #default = Bar | baz = Baz }} → Bar

defaultパラメータが省略しょうりゃくされ、一致いっちが行おこなわれない場合ばあい、result(結果けっか)は返かえされません。

{{#switch: test | foo = Foo | baz = Baz }} →

グループ化かの結果けっか

いくつかの case 文字もじ列れつに同おなじ result 文字もじ列れつを返かえす「フォールスルー」値ねを持もたせることができます。これにより重複じゅうふくを最小限さいしょうげんに抑おさえることができます。

{{#switch: comparison string
 | case1 = result1
 | case2 
 | case3 
 | case4 = result234
 | case5 = result5
 | case6 
 | case7 = result67
 | #default = default result
}}

ここではケース2と3、4とも出力しゅつりょくはresult234です。ケース6と7の出力しゅつりょくは両方りょうほうともresult67です上記じょうきの場合ばあい、最後さいごのパラメータの「#default = 」は省略しょうりゃくできます。

パラメータとともに使用しよう

この関数かんすうは、テスト文字もじ列れつとしてパラメータとともに使用しようできます。この場合ばあい、大文字おおもじと小文字こもじを文字もじ列れつ「{{{parameter name}}}」に設定せっていする可能かのう性せいは非常ひじょうに低ひくいため、パラメータ名めいの後のちにパイプを配置はいちする必要ひつようはありません。 (これは、パイプが存在そんざいせず、パラメーターが存在そんざいしないか、値ねがある場合ばあいにパラメーターがデフォルトで設定せっていする値ねです。 Help:テンプレート内ないでのパーサー関数かんすうを参照さんしょうしてください。)

{{#switch: {{{1}}} | foo = Foo | baz = Baz | Bar }}

上記じょうきの場合ばあい、{{{1}}}がfooに等ひとしい場合ばあい、関数かんすうはFooを返かえします。 bazに等ひとしい場合ばあい、関数かんすうはBazを返かえします。パラメータが空そらであるか存在そんざいしない場合ばあい、関数かんすうはBarを返かえします。

上記じょうきのセクションのように、ケースを組くみ合あわせて単一たんいつの結果けっかを得えることができます。

{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | Bar }}

ここで、{{{1}}}がfoo、zoo、またはrooに等ひとしい場合ばあい、関数かんすうはFooを返かえします。 bazに等ひとしい場合ばあい、関数かんすうはBazを返かえします。パラメータが空そらであるか存在そんざいしない場合ばあい、関数かんすうはBarを返かえします。

さらに、テストパラメータ値ちがいずれの場合ばあいにも一致いっちしない場合ばあいに何なにも返かえしたくない場合ばあいは、デフォルトの結果けっかを省略しょうりゃくできます。

{{#switch: {{{1}}} | foo = Foo | bar = Bar }}

この場合ばあい、{{{1}}}が存在そんざいしてfooまたはbarに等ひとしい場合ばあいを除のぞき、関数かんすうは空そらの文字もじ列れつを返かえします。この場合ばあい、関数かんすうはそれぞれFooまたはBarを返かえします。

これは、デフォルトの結果けっかを空そらとして宣言せんげんするのと同おなじ効果こうかがあります。

{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | }}

何なんらかの理由りゆうでケースを「{{{parameter name}}}」に設定せっていすると、パラメーターが存在そんざいしないか値ねがない場合ばあいに、関数かんすうはそのケースの結果けっかを返かえします。関数かんすうのデフォルトの結果けっかを返かえすには、パラメーターが存在そんざいし、文字もじ列れつ「{{{parameter name}}}」以外いがいの値ねを持もっている必要ひつようがあります。

({{{1}}}が存在そんざいしないか、空そらの場合ばあい):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Foo

({{{1}}}の値ねが「test」の場合ばあい):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Bar

({{{1}}}の値ねが「{{{1}}}」の場合ばあい):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Foo

この架空かくうのケースでは、パイプをパラメーター({{{1|}}})に追加ついかする必要ひつようがあります。

比較ひかくの挙動きょどう

#ifeq 同様どうよう、比較ひかくは比較ひかくする文字もじ列れつと対象たいしょうの格かく文字もじ列れつが数値すうちである場合ばあい、数値すうちとして処理しょりされます。あるいは大文字おおもじ小文字こもじを識別しきべつする文字もじ列れつとして処理しょりされます。

{{#switch: 0 + 1 | 1 = one | 2 = two | three}} → three

{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}} → one

{{#switch: 02 | +1 = one | +2 = two | three}} → two

{{#switch: 100 | 1e1 = ten | 1e2 = hundred | other}} → hundred

{{#switch: a | a = A | b = B | C}} → A

{{#switch: A | a = A | b = B | C}} → C

case文字もじ列れつは空白くうはくの場合ばあいがあります。

{{#switch: | = Nothing | foo = Foo | Something }} → Nothing

一致いっちが見みつかると、それ以降いこうのcasesは無視むしされます。

{{#switch: b | f = Foo | b = Bar | b = Baz | }} → Bar

警告けいこく:

#switchおよび#ifeqを使用しようした数値すうち比較ひかくは、式しきの比較ひかくと同等どうとうではありません(上記じょうきも参照さんしょう)。

{{#switch: 12345678901234567 | 12345678901234568 = A | B}} → B

{{#ifexpr: 12345678901234567 = 12345678901234568 | A | B}} → A

生なまの等号とうごう

"Case" 文字もじ列れつには生なまの等号とうごうを含ふくめることができません。これを回避かいひするには、{{=}} マジックワードを使用しようして、等号とうごう記号きごうを HTML コード = に置おき換かえます。

例れい:

入力にゅうりょく	出力しゅつりょく
{{#switch: 1=2 \| 1=2 = raw \| 1<nowiki>=</nowiki>2 = nowiki \| 1{{=}}2 = template \| default }}	template
{{#switch: 1=2 \| 1=2 = html \| default }}	html

この関数かんすうを実社会じっしゃかいで使つかう易やさしい例れいとしてNBA Template:NBA color (訳注やくちゅう：バスケットボールチームの配色はいしょく用ようテンプレート) を参照さんしょうしてください。複雑ふくざつなサンプルは Template:Extension (テンプレート:拡張かくちょう機能きのう) と w:Template:BOTREQ (訳注やくちゅう：Bot作業さぎょう依頼いらいのコメント用ようテンプレート) の2件けんを参照さんしょうしてください。

#ifeqの置換ちかん

拡張かくちょう深度しんどを減へらすには #switch を使用しよう。

例たとえば:

{{#switch:{{{1}}} |condition1=branch1 |condition2=branch2 |condition3=branch3 |branch4}}

は、以下いかと同等どうとうです

{{#ifeq:{{{1}}}|condition1 |branch1 |{{#ifeq:{{{1}}}|condition2 |branch2 |{{#ifeq:{{{1}}}|condition3 |branch3 |branch4}}}}}}

つまり、深ふかい入いれ子こ、線形せんけい:

{{#ifeq:{{{1}}}|condition1
  |<!--then-->branch1
  |<!--else-->{{#ifeq:{{{1}}}|condition2
                |<!--then-->branch2
                |<!--else-->{{#ifeq:{{{1}}}|condition3
                              |<!--then-->branch3
                              |<!--else-->branch4}}}}}}

一方いっぽう、switchの交換こうかんは、両方りょうほうのブランチにネストされたIF(インデントの代替だいたいで示しめされ、両側りょうがわにインデントされている)の場合ばあい、複雑ふくざつ/非ひ実用じつよう的てきであり、完全かんぜんに対称たいしょう的てきなツリーになります。

{{#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
    }}
  }}
}}

#time

コード	説明せつめい	現在げんざいの出力しゅつりょく (更新こうしんするにはこのページのキャッシュを破棄はきしてください)
年とし
`Y`	4 桁けたの年とし	2024
`y`	2 桁けたの年とし	24
`L`	閏年うるうどしの場合ばあい 1、平年へいねんの場合ばあい 0	1
`o`^{[note 1]}	指定していした週しゅうの ISO-8601 年ねん^{[note 2]}	2024^{[note 3]}
↑ PHP 5.1.0 以降いこうおよび rev:45208 が必要ひつよう ↑ Y と等ひとし値ちになるが、ISO 週番しゅうばん号ごう (W) が前月ぜんげつもしくは次月しづきの場合ばあい、年としで代用だいよう。 ↑ 注ちゅう1の場合ばあいが未み記入きにゅうだと、リテラルo を出力しゅつりょく。
月つき
`n`	月番つきばん号ごう、ゼロ補完ほかんなし	4
`m`	月番つきばん号ごう、ゼロ補完ほかんあり	04
`M`	サイトの言語げんごでの月つき名めいの省略形しょうりゃくけい	4月がつ
`F`	サイトの言語げんごでの完全かんぜんな月つき名めい	4月がつ
`xg`	属ぞく格かくと主格しゅかくを区別くべつする表示ひょうじ言語げんごでは、月つきの名前なまえの表記ひょうきを属ぞく格かく形式けいしきで出力しゅつりょく。このオプションはスラヴ語ご派はのポーランド語ごやロシア語ご、ベラルーシ語ごやチェコ語ご、スロバキア語ごやスロベニア語ご、ウクライナ語ごなどに使つかえる。	ポーランド語ごの例れい: `{{#time:F Y\|June 2010\|pl}}` → czerwiec 2010 (主格しゅかく) `{{#time:d xg Y\|20 June 2010\|pl}}` → 20 czerwca 2010 (所有しょゆう格かく)
月つきまたは年としの通算つうさん日び
`j`	日にち、ゼロ補完ほかんなし	30
`d`	日にち、ゼロ補完ほかんあり	30
`z`	日ひ (1月がつ 1 = 0). 注ちゅう: ISO 日付ひづけを得えるには 1 を加算かさんする。	120
週しゅうおよび曜日ようび
`W`	ISO 8601 週しゅう番号ばんごう、ゼロ補完ほかんあり	18
`N`	ISO 8601 曜日ようび番号ばんごう (月曜日げつようび = 1、日曜日にちようび = 7)	2
`w`	曜日ようび番号ばんごう (日曜日にちようび = 0、土曜日どようび = 6)	2
`D`	曜日ようびの略号りゃくごう。翻訳ほんやくされない場合ばあいが多おおい。	火ひ
`l`	曜日ようびの省略しょうりゃくしない表記ひょうき。翻訳ほんやくされない場合ばあいが多おおい。	火曜日かようび
時とき
`a`	午前ごぜん (00:00:00 ～ 11:59:59) の場合ばあい「am」、午後ごご (12:00:00 ～ 23:59:59) の場合ばあい「pm」	pm
`A`	上うえの `a` の大文字おおもじ版ばん。	PM
`g`	時とき、12 時じ間あいだ制せい、ゼロ補完ほかんなし	4
`h`	時とき、12 時じ間あいだ制せい、ゼロ補完ほかんあり	04
`G`	時とき、24 時じ間あいだ制せい、ゼロ補完ほかんなし	16
`H`	時とき、24 時じ間あいだ制せい、ゼロ補完ほかんあり	16
分ぶんと秒びょう
`i`	分ぶん、ゼロ補完ほかんあり	38
`s`	秒びょう、ゼロ補完ほかんあり	55
`U`	Unix 日時にちじ。 1970年ねん1月がつ1日にち 00:00:00 GMT からの経過けいか秒びょう数すう	1714495135
タイムゾーン (1.22wmf2 時点じてん)
`e`	タイムゾーン識別子しきべつし	UTC
`I`	日時にちじがサマータイムかどうか	0
`O`	グリニッジ標準時ひょうじゅんじ (GMT) との差さ	+0000
`P`	グリニッジ標準時ひょうじゅんじ (GMT) との差さ、コロン付つき	+00:00
`T`	タイムゾーンの省略形しょうりゃくけい	UTC
`Z`	タイムゾーンのオフセット (秒びょう)	0
その他た
`t`	日ひ	30
`c`	ISO 8601 形式けいしきの日付ひづけ、`Y-m-d"T"H:i:s+00:00` と同等どうとう。	2024-04-30T16:38:55+00:00
`r`	RFC 5322 形式けいしきの日時にちじ、`D, j M Y H:i:s +0000` と同等どうとうだが、曜日ようびと月つき名めいは国際こくさい化かされない。	Tue, 30 Apr 2024 16:38:55 +0000
グレゴリオ暦れき以外いがい
イスラム暦れき
`xmj`	日ひ	21
`xmF`	完全かんぜんな月つき名めい	シャウワール
`xmn`	月番つきばん号ごう	10
`xmY`	完全かんぜんな年とし	1445
イラン暦れき (Jalaly)
`xit`	月間げっかんの日数にっすう	31
`xiz`	日ひ	41
`xij`	日ひ	11
`xiF`	完全かんぜんな月つき名めい	オルディーベヘシュト
`xin`	月番つきばん号ごう	2
`xiY`	完全かんぜんな年とし	1403
`xiy`	2 桁けたの年とし	03
ユダヤ暦れき
`xjj`	日ひ	22
`xjF`	完全かんぜんな月つき名めい	ニサン
`xjt`	月つきの日数にっすう	30
`xjx`	月つき名めいの所有しょゆう格かく	ニサン
`xjn`	月番つきばん号ごう	7
`xjY`	完全かんぜんな年とし	5784
タイ太陽暦たいようれき
`xkY`	タイ太陽暦たいようれきの完全かんぜんな年とし。注ちゅう: 1941 年ねんより前まえの 1 月がつから 3 月がつの範囲はんいは、適切てきせつには計算けいさんできません。	2567
民みん国こく紀元きげん/主体しゅたい暦れき
`xoY`	完全かんぜんな年とし	113
日本にっぽんの年号ねんごう
`xtY`	完全かんぜんな年とし	令れい和わ6
フラグ
`xn`	後続こうぞくの数値すうちをそのまま半角はんかく英数字えいすうじに整形せいけいする。	ヒンディー語ごでは、`{{#time:H, xnH}}` は ०६, 06 を返かえす。
`xN`	`xn` と同様どうようですが、トグルフラグとして文字もじ列れつの終端しゅうたんまたは文字もじ列れつに次つぎの `xN` が出現しゅつげんするまで保持ほじされます。
`xr`	後続こうぞくの数値すうちをローマ数字すうじに整形せいけいする。10,000 までの数値すうちで動作どうさする。 (MediaWiki 1.20 以前いぜんは上限じょうげん 3,000)	`{{#time:xrY}}` → MMXXIV
`xh`	後続こうぞくの数値すうちをヘブライ数字すうじに整形せいけいする。	`{{#time:xhY}}` → ב'כ"ד

このパーサ関数かんすうは日付ひづけあるいは時間じかん (グレゴリア暦れき) を取とって指定していの文法ぶんぽうどおりにフォーマットします。日にち・時間じかんのオブジェクトを特定とくていする方法ほうほう; 既定きてい値ちはマジックワード {{CURRENTTIMESTAMP}} – つまりページが最近さいきん HTML 形式けいしきで表示ひょうじされた日時にちじ。

{{#time: format string }}

{{#time: format string | date/time object }}

{{#time: format string | date/time object | language code }}

{{#time: format string | date/time object | language code | local }}

右みぎの図ずには利用りようできる書式しょしきコードをまとめてあります。書式しょしき文字もじ列れつ内ないにこれら以外いがいの文字もじが含ふくまれると、未み処理しょりで出力しゅつりょくします。空白くうはく類るいも扱あつかいは同様どうようです (コードの解析かいせきに不要ふようなため)。 If no character is recognized in the formatting string, and the date/time object is without error, then the formatting string is returned as output. また書式しょしき文字もじ列れつ内ないの文字もじをエスケープする方法ほうほうが 2 つあります。

バックスラッシュに続つづけて書式しょしき指定してい文字もじ列れつを記述きじゅつすると、ひとまとまりのリテラル文字もじとして解釈かいしゃく
文字もじ列れつを二に重じゅう引用いんよう符ふで囲かこむと、リテラル文字もじとして扱あつかい引用いんよう符ふを除去じょきょ。

またさらに、有向ゆうこうグラフ xx の場合ばあい、ひとまとまりのリテラル文字もじ「x」と解釈かいしゃくします。

As the list of formatting codes continues to evolve (with the support of new calendars, or of new date fields computed and formatted differently), you should escape all literal characters (not just ASCII letters currently used by formatting codes) that need to be passed through unaltered.

Unfortunately, for now, the ASCII single quote is still not recognized as a simple alternative for marking literal text to the currently supported ASCII double quotes (for example, double quotes are mandatory for in other uses like the delimitation of string values in JSON, C, C++...) and backslashes (which have to be escaped as well in string constants used by many languages, including JSON, C, C++, PHP, JavaScript, Lua). So you still cannot embed any literal double quote without escaping it with a backslash (or you can use other curly, angular or square quotation marks instead).

{{#time: Y-m-d }} → 2024-04-30

{{#time: [[Y]] m d }} → 2024 04 30

{{#time: [[Y (year)]] }} → 2024 (24UTCpmTue, 30 Apr 2024 16:38:55 +0000)

{{#time: [[Y "(year)"]] }} → 2024 (year)

{{#time: i's" }} → 38'55"

PHPはdate/time objectを受うけ取とると、どの書式しょしきでも strtotime() 関数かんすうで処理しょりします (訳注やくちゅう：英文えいぶん形式けいしきの日付ひづけを Unix タイムスタンプに変換へんかん)。 Absolute (e.g. 20 December 2000), relative (e.g. +20 hours), and combined times (e.g. 30 July +1 year) are accepted.

{{#time: r|now}} → Tue, 30 Apr 2024 16:38:56 +0000

{{#time: r|+2 hours}} → Tue, 30 Apr 2024 18:38:56 +0000

{{#time: r|now + 2 hours}} → Tue, 30 Apr 2024 18:38:56 +0000

{{#time: r|20 December 2000}} → Wed, 20 Dec 2000 00:00:00 +0000

{{#time: r|December 20, 2000}} → Wed, 20 Dec 2000 00:00:00 +0000

{{#time: r|2000-12-20}} → Wed, 20 Dec 2000 00:00:00 +0000

{{#time: r|2000 December 20}} → Error: Invalid time.

ISO 639-3 (?) の言語げんごコードにより、文字もじ列れつを選択せんたくした言語げんごで表示ひょうじします。

{{#time:d F Y|1988-02-28|nl}} → 28 februari 1988

{{#time:l|now|uk}} → вівторок

{{#time:d xg Y|20 June 2010|pl}} → 20 czerwca 2010

localパラメーターは、「日付ひづけ/時刻じこくオブジェクト」がローカルタイムゾーンを参照さんしょうするかUTCを参照さんしょうするかを指定していします。

これは真偽しんぎ値ちのパラメーターです。その値ねは、引数ひきすうの値ねをキャストすることによって決定けっていされます(文字もじ列れつを真偽しんぎ値ちにキャストする方法ほうほうの詳細しょうさいについては、公式こうしきPHPドキュメントを参照さんしょうしてください)。

変数へんすう$wgLocaltimezoneがUTCに設定せっていされている場合ばあい、localがtrueまたはfalseに設定せっていされていても、出力しゅつりょくに違ちがいはないことに注意ちゅういしてください。

詳細しょうさいについては、次つぎの例れいを参照さんしょうしてください:

{{#time: Y F d H:i:s|now|it|0}} → 2024 aprile 30 16:38:56

{{#time: Y F d H:i:s|now|it|1}} → 2024 aprile 30 16:38:56

{{#time: Y F d H:i:s|+2 hours||0}} → 2024 4月がつ 30 18:38:56

{{#time: Y F d H:i:s|+2 hours||1}} → 2024 4月がつ 30 18:38:56

{{#time:c|2019-05-16T17:05:43+02:00|it}} → 2019-05-16T15:05:43+00:00

{{#time:c|2019-05-16T17:05:43+02:00|it|0}} → 2019-05-16T15:05:43+00:00

{{#time:c|2019-05-16T17:05:43+02:00|it|true}} → 2019-05-16T15:05:43+00:00

Unix タイムスタンプを計算けいさんする場合ばあいは、文字もじ列れつの先頭せんとうに @ 記号きごうを付つけると日付ひづけ計算けいさんに使つかえます。

{{#time: U | now }} → 1714495136

{{#time: r | @1714495135 }} → Tue, 30 Apr 2024 16:38:55 +0000

警告けいこく:

もしタイムスタンプの数値すうちの先頭せんとうに @ を付つけないと、ほぼ毎回まいかい、エラーか想定そうてい外がいの値ねを返かえします。

{{#time: r | 1970-01-01 00:16:39 }} → Thu, 01 Jan 1970 00:16:39 +0000

{{#time: U | 1970-01-01 00:16:39 }} → 999

{{#time: r | @999 }} → Thu, 01 Jan 1970 00:16:39 +0000 (正ただしい)

{{#time: r | 999 }} → Error: Invalid time. (年としの書式しょしきが想定そうてい外がい)

{{#time: r | 1970-01-01 00:16:40 }} → Thu, 01 Jan 1970 00:16:40 +0000

{{#time: U | 1970-01-01 00:16:40 }} → 1000

{{#time: r | @1000 }} → Thu, 01 Jan 1970 00:16:40 +0000 (正ただしい)

{{#time: r | 1000 }} → Wed, 30 Apr 1000 00:00:00 +0000 (年としを想定そうてい、今日きょうの月日つきひを添そえる)

{{#time: r | 1970-01-01 02:46:39 }} → Thu, 01 Jan 1970 02:46:39 +0000

{{#time: U | 1970-01-01 02:46:39 }} → 9999

{{#time: r | @9999 }} → Thu, 01 Jan 1970 02:46:39 +0000 (正ただしい)

{{#time: r | 9999 }} → Fri, 30 Apr 9999 00:00:00 +0000 (年としを想定そうてい、今日きょうの月日つきひを添そえる)

{{#time: r | 1970-01-01 02:46:40 }} → Thu, 01 Jan 1970 02:46:40 +0000

{{#time: U | 1970-01-01 02:46:40 }} → 10000

{{#time: r | @10000 }} → Thu, 01 Jan 1970 02:46:40 +0000 (正ただしい)

{{#time: r | 10000 }} → Error: Invalid time. (年としの書式しょしきが想定そうてい外がい)

警告けいこく:

許容きょようできる入力にゅうりょく値ちは「1 January 0111 → 31 December 9999」の範囲はんいです。年としは100から110までが不ふ定形ていけいです。Y (年とし) とうるう年どしはその 100-110 と同様どうように不ふ定形ていけい、r (RFC 5322 形式けいしき)、D (曜日ようび略号りゃくごう)、l (曜日ようび)、U (Unix日時にちじ) を記述きじゅつすると年としを 2000-2010 の範囲はんいとして解釈かいしゃくします。

{{#time: d F Y | 29 Feb 0100 }} → 01 3月がつ 0100
(これはうるう年どしではないから出力しゅつりょくは正ただしい)、ただし

{{#time: r | 29 Feb 0100 }} → Mon, 01 Mar 0100 00:00:00 +0000 (こちらは間違まちがい。100 を2000と解釈かいしゃくできたのに、うるう年どしだったため。)

{{#time: d F Y | 15 April 10000 }} → Error: Invalid time.

{{#time: r | 10000-4-15 }} → Sat, 15 Apr 2000 10:00:00 +0000

先頭せんとうに 0 を付つけて 4 桁けたの書式しょしきにした場合ばあいを除のぞいて、年としの値ね 0-99 は 2000-2069 年ねんおよび 1970-1999 年ねんと解釈かいしゃくされます:

{{#time: d F Y | 1 Jan 6 }} → 01 1月がつ 2006

{{#time: d F Y | 1 Jan 06 }} → 01 1月がつ 2006

{{#time: d F Y | 1 Jan 006 }} → 01 1月がつ 2006

{{#time: d F Y | 1 Jan 0006 }} → 01 1月がつ 0006 (4-digit format)

日ひは年としが 100-110 の範囲はんいか、1753以上いじょうで与あたえられ、原因げんいんは 111-1752 の範囲はんいでは r-出力しゅつりょくが「不明ふめい」、l-出力しゅつりょくが「<>」となってしまうからです。結果けっかとして、r-出力しゅつりょくはこれらの範囲はんいの年としの入力にゅうりょく値ちとして許容きょようされません。

完全かんぜんまたは部分ぶぶん的てきな絶対ぜったい日付ひづけを指定していできます。この関数かんすうは current 値ねを使用しようして、指定していされていない日付ひづけの部分ぶぶんを「補完ほかん」します。

{{#time: Y | January 1 }} → 2024

警告けいこく:

補完ほかんの関数かんすうは不ふ定形ていけいです。特定とくていの部分ぶぶんは現在げんざいの値ねで補完ほかんされ、別べつの部分ぶぶんはエラーになります。

{{#time: Y m d H:i:s | June }} → 2024 06 30 00:00:00 この例れいは日ひのゼロ時じゼロ分ふん、現在げんざいの日ひ、数式すうしきに記述きじゅつした月つき (June=6月がつ) と年としを表示ひょうじ。

{{#time: Y m d H:i:s | 2003 }} → 2003 04 30 00:00:00 この例れいはゼロ時じゼロ分ふん、現在げんざいの月日つきひ、数式すうしきに記述きじゅつした年としを表示ひょうじ。

満員まんいんの日ひの例外れいがいケースがあります:

{{#time: Y m d H:i:s | June 2003 }} → 2003 06 01 00:00:00 1日にちの始はじまりと月つきの始はじまりを示しめします。

4桁けたの数字すうじは常つねに年としとして解釈かいしゃくされ、時間じかんや分ぶんとしては解釈かいしゃくされません。^[1]

{{#time: Y m d H:i:s | 1959 }} → 1959 04 30 00:00:00

6桁けたの数字すうじは時間じかんと解釈かいしゃく、できるかぎり分ぶんと秒びょうまで出力しゅつりょくしようとしますが、それ以外いがいの場合ばあいはエラーになります (たとえば年月日ねんがっぴとは解釈かいしゃくしません)。

{{#time: Y m d H:i:s | 195909 }} → 2024 04 30 19:59:09 記述きじゅつしたコードは年としとゼロ補完ほかんの月つきと日ひを要求ようきゅうしたのに、出力しゅつりょくは時間じかんとして解釈かいしゃく。

{{#time: Y m d H:i:s | 196009 }} → Error: Invalid time. 19:60:09 は有効ゆうこうな時刻じこくではないにもかかわらず、196009 は1960年ねん9月がつとは解釈かいしゃくされません。

関数かんすうは日付ひづけ計算けいさんをこなそうとします。（訳注やくちゅう：Fは「サイトの言語げんごでの完全かんぜんな月つき名めい」、dはゼロ補完ほかんの日ひを求もとめ、入力にゅうりょく値ちの不備ふびで出力しゅつりょく結果けっかが不ふ定形ていけい。）

{{#time: d F Y | January 0 2008 }} → 31 12月がつ 2007

{{#time: d F | January 32 }} → Error: Invalid time.

{{#time: d F | February 29 2008 }} → 29 2月がつ

{{#time: d F | February 29 2007 }} → 01 3月がつ

{{#time:Y-F|now -1 months}} → 2024-3月がつ

#timeに対たいする書式しょしき文字もじ列れつの総そう文字数もじすう（すべての呼よび出だしでの総和そうわ）は半角はんかく6000文字もじに制限せいげんされています^[2]。

タイムゾーンの問題もんだい点てん

この#timeパーサ関数かんすう(より具体ぐたい的てきにはPHP DateTime )には相対そうたい的てきなタイムゾーンオフセットとして整数せいすう以外いがい は渡わたせないというバグがあります。EDT (東部とうぶ夏時間なつじかん) など時間じかん通どおりのタイムゾーンを使用しようする場合ばあい、この問題もんだいは発生はっせいしません。例れいをあげます。：

{{#time:g:i A | -4 hours }} → 12:38 PM

ところがインドは UTC (協定きょうてい世界せかい時じ) との時差じさが +5.5 時じ間あいだのため、タイムゾーンを適用てきようすると通常つうじょうなら正ただしいオフセットの計算けいさんに失敗しっぱいするはずです。実例じつれいはこちら:

{{#time:g:i A | +5.5 hours }} → 4:38 PM

そこで回避かいひ策さくとして、単純たんじゅんに時間じかんを分わか秒びょう (minutes か seconds) に換算かんさんして、次つぎの例れいのように与あたえます。

{{#time:g:i A | +330 minutes }} → 10:08 PM
{{#time:g:i A | +19800 seconds }} → 10:08 PM

(関数かんすうの開発かいはつ者しゃ Tim Starling がこれを解決かいけつする構文こうぶんを書かいてくれました。)

#timel

この関数かんすうは構文こうぶんのショートカットで local パラメータに true を設定せっていすると挙動きょどうは {{#time: ... }} と同一どういつ、常つねに利用りよう者しゃが設定せっていした標準時ひょうじゅんじまたはウィキが設定せっていした時間じかん帯たいを使用しよう (タイムゾーンの設定せっていは $wgLocaltimezone に従したがう)

関数かんすうの構文こうぶんは次つぎのとおりです:

{{#timel: format string }}

{{#timel: format string | date/time object }}

{{#timel: format string | date/time object | language code }}

変数へんすう$wgLocaltimezoneがUTCに設定せっていされている場合ばあい、localがtrueまたはfalseに設定せっていされていても、出力しゅつりょくに違ちがいはないことに注意ちゅういしてください。

タイムゾーンがUTCではないサーバーからの#timeおよび#timelパーサー関数かんすうの使用しよう例れい

例たとえば、以下いかの例れいを参照さんしょうしてください:

{{#time:c|now|it}} → 2024-04-30T16:38:56+00:00

{{#time:c|now|it|0}} → 2024-04-30T16:38:56+00:00

{{#time:c|now|it|1}} → 2024-04-30T16:38:56+00:00

{{#timel:c|now|it}} → 2024-04-30T16:38:56+00:00

警告けいこく:

UTC(旧称きゅうしょうGMT)とは異ことなるタイムゾーンのウィキペディアでは、1970-01-01 00:00:00 UTC以降いこう、時間じかんと時間じかんの両方りょうほうのUが同おなじ秒びょう数すうを返かえすことに注意ちゅういしてください。

U Unix時間じかん。 1970年ねん1月がつ1日にち00:00:00 GMTからの秒びょう数すう。

Z タイムゾーンのオフセット (秒びょう)

{{#time: U}} → 1714495135

{{#timel: U}} → 1714495135

{{#time: Z}} → 0

{{#timel: Z}} → 0

#titleparts

この関数かんすうは、ページのタイトルをスラッシュに基もとづいてセグメントに分離ぶんりし、それらのセグメントの一部いちぶを出力しゅつりょくします。

{{#titleparts: ページ名めい | 返かえすセグメント数すう | 最初さいしょに返かえすセグメント }}

「返かえされるセグメントの数かず」パラメータが指定していされていない場合ばあい、デフォルトで「0」になり、「最初さいしょに返かえされるセグメント」(含ふくまれている)からすべてのセグメントが返かえされます。「最初さいしょに返かえすセグメント」パラメータが指定していされていないか「0」の場合ばあい、デフォルトで「1」になります。

{{#titleparts: Talk:Foo/bar/baz/quok }} → Talk:Foo/bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | 1 }} → Talk:Foo {{ROOTPAGENAME}} も参照さんしょうしてください。

{{#titleparts: Talk:Foo/bar/baz/quok | 2 }} → Talk:Foo/bar

{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 2 }} → bar/baz

{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 3 }} → baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | 3 | 2 }} → bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | | 2 }} → bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | | 5 }} →

両方りょうほうの値ねに負まけの値ねが受うけ入いれられます。返かえされるセグメントの数かずパラメータの負まけの値ねは、文字もじ列れつの末尾まつびからセグメントを効果こうか的てきに「ストリップ」します。「最初さいしょに返かえされるセグメント」の負まけの値ねは、「このセグメントを右みぎから数かぞえて開始かいしする」という意味いみになります。

{{#titleparts: Talk:Foo/bar/baz/quok | -1 }} → Talk:Foo/bar/baz 文字もじ列れつの最後さいごから数かぞえてはじめのセグメントを削除さくじょします。 {{BASEPAGENAME}} も参照さんしょうしてください。

{{#titleparts: Talk:Foo/bar/baz/quok | -4 }} → 文字もじ列れつの末尾まつびから4つのセグメントすべてを削除さくじょします

{{#titleparts: Talk:Foo/bar/baz/quok | -5 }} → 文字もじ列れつの末尾まつびから5つのセグメントを削除さくじょします(存在そんざいする以上いじょう)

{{#titleparts: Talk:Foo/bar/baz/quok | | -1 }} → quok 最後さいごのセグメントを返かえします。 {{SUBPAGENAME}} も参照さんしょうしてください。

{{#titleparts: Talk:Foo/bar/baz/quok | -1 | 2 }} → bar/baz 文字もじ列れつの末尾まつびから1つのセグメントを削除さくじょしてから、2番目ばんめ以降いこうのセグメントを返かえします

{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2 }} → baz 最後さいごから2番目ばんめの要素ようそからコピーを開始かいしします。文字もじ列れつの末尾まつびから1つのセグメントを削除さくじょします

処理しょりする前まえに、「pagename」パラメータはHTMLでデコードされます。標準ひょうじゅんのHTML文字もじエンティティが含ふくまれている場合ばあい、それらはプレーン文字もじに変換へんかんされます(UTF-8で内部ないぶ的てきにエンコードされます。つまり、MediaWikiソースページで使用しようするのと同おなじエンコードです。このパーサー関数かんすう)。

たとえば、pagenameに"、"、または"が含ふくまれている場合ばあいは、"に置おき換かえられます。

HTMLからプレーンテキストへの他ほかの変換へんかんは実行じっこうされないため、HTMLタグは、ページタイトルで無効むこうであっても、この最初さいしょのステップではそのまま残のこります。

Some magic keywords or parser functions of MediaWiki (such as {{PAGENAME }} and similar) are known to return strings that are needlessly HTML-encoded, even if their own input parameter was not HTML-encoded:

The titleparts parser function can then be used as a workaround, to convert these returned strings so that they can be processed correctly by some other parser functions also taking a page name in parameter (such as {{PAGESINCAT: }} but which are still not working properly with HTML-encoded input strings.

For example, if the current page is Category:Côte-d'Or, then:

{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}, and {{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }} are both returning 1; (the #ifeq parser function does perform the HTML-decoding of its input parameters).
{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}, and {{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }} are both returning 1; (the #switch parser function does perform the HTML-decoding of its input parameters).
{{#ifexist: {{FULLPAGENAME}} | 1 | 0 }}, {{#ifexist: Category:Côte-d'Or | 1 | 0 }}, or even {{#ifexist: Category:Côte-d'Or | 1 | 0 }} will all return 1 if that category page exists (the #ifexist parser function does perform the HTML-decoding of its input parameters);
{{PAGESINCAT: Côte-d'Or }} will return a non-zero number, if that category contains pages or subcategories, but:
{{PAGESINCAT: {{CURRENTPAGENAME}} }}, may still unconditionally return 0, just like:
{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}
{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}

The reason of this unexpected behavior is that, with the current versions of MediaWiki, there are two caveats:

{{FULLPAGENAME}}, or even {{FULLPAGENAME:Côte-d'Or}} may return the actually HTML-encoded string Category:Côte-d'Or and not the expected Category:Côte-d'Or, and that:
{{PAGESINCAT: Côte-d'Or }} unconditionally returns 0 (the PAGESINCAT magic keyword does not perform any HTML-decoding of its input parameter).

The simple workaround using titleparts (which will continue to work if the two caveats are fixed in a later version of MediaWiki) is:

{{PAGESINCAT: {{#titleparts: {{CURRENTPAGENAME}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}, that all return the actual number of pages in the same category.

Then the decoded pagename is canonicalized into a standard page title supported by MediaWiki, as much as possible:

All underscores are automatically replaced with spaces:
{{#titleparts: Talk:Foo/bah_boo|1|2}} → bah boo Not bah_boo, despite the underscore in the original.
The string is split a maximum of 25 times; further slashes are ignored and the 25th element will contain the rest of the string. The string is also limited to 255 characters, as it is treated as a page title:
{{#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 }} → y/z/aa/bb/cc/dd/ee

If for whatever reason you needed to push this function to its limit, although very unlikely, it is possible to bypass the 25 split limit by nesting function calls:

{{#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}} → z
Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
{{#titleparts: talk:a/b/c }} → Talk:A/b/c

You can use #titleparts as a small "string parser and converter", but consider that it returns the first substring capitalized:

{{#titleparts: one/two/three/four|1|1 }} → One

{{#titleparts: one/two/three/four|1|2 }} → two

小文字こもじを求もとめるには lc: 関数かんすうを使つかい出力しゅつりょくをコントロールします。

{{lc: {{#titleparts: one/two/three/four|1|1 }} }} → one

You can prepend a 'dummy' slash at the beginning of the string to get the correct first substring capitalization (uppercase or lowercase). Use 2 instead of 1 for first segment to return:

{{#titleparts: /one/two/three/four|1|2 }} → one

{{#titleparts: /One/two/three/four|1|2 }} → One

警告けいこく:

Certain characters that are illegal in a page title will cause #titleparts to not parse the string:

{{#titleparts: {one/two} | 1 | 1 }} → {one/two}. 以下いかの値ねにはなりません: {one

{{#titleparts: [[page]]/123 | 1 | 2 }} → page/123. Does not work because brackets are illegal in page titles and this parser function does not process links embedded in its input pagename parameter, even when they use the MediaWiki syntax, or any other HTML or MediaWiki tags.

{{#titleparts: red/#00FF00/blue | 1 | 3 }} → "". Does not work because "#" is also illegal in page titles.

警告けいこく:

If any part of the title is just "." or "..", #titleparts will not parse the string:

{{#titleparts: one/./three | 1 | 1 }} → one/./three. The whole string is returned. It does not produce the expected: one

警告けいこく:

This function does not degrade gracefully if the input exceeds 255 bytes in UTF-8. If the input string is 256 bytes or more, the whole string is returned.

String functions

The ParserFunctions extension optionally defines various string functions (#len, #pos, #rpos, #sub, #count, #replace, #explode, #urldecode) if $wgPFEnableStringFunctions is set to true.

警告けいこく:

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). These functions do NOT work on Wikimedia wikis!

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 Lua. For example, the English Wikipedia uses Module:String, which does some of the same things with wildly different syntax. There are also individual String-handling templates.

See here for examples.

Here is a short overview of Module:String functions:

#len (length of string): {{#invoke:String|len|target_string}}
#sub (substring): {{#invoke:String|sub|target_string|start_index|end_index}}
#match: {{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}
#pos (position of target): {{#invoke:String|pos|target_string|index_value}}
#find: {{#invoke:String|find|source_string|target_string|start_index|plain_flag}}
#replace: {{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}
#rep (repeat): {{#invoke:String|rep|source|count}}
#escapePattern: {{#invoke:String|escapePattern|pattern_string}}
#count: {{#invoke:String|count|source_str|pattern_string|plain_flag}}
#join: {{#invoke:String|join|separator|string1|string2|...}}

全般ぜんぱん的てきな情報じょうほう

subst展開てんかい

パーサー関数かんすうの subst展開てんかいは、ハッシュ記号きごうの前まえにsubst:を足たします。

{{subst:#ifexist: Help:Extension:ParserFunctions/ja | [[Help:Extension:ParserFunctions/ja]] | Help:Extension:ParserFunctions/ja }}

→ [[Help:Extension:ParserFunctions/ja]] というページが存在そんざいするため、コード Help:Extension:ParserFunctions/ja がウィキテキストに挿入そうにゅうされます。

警告けいこく:

The results of substituted parser functions are undefined if the expressions contain unsubstituted volatile code such as variables or other parser functions. For consistent results, all the volatile code in the expression to be evaluated must be substituted. See Help:Substitution.

Subst展開てんかいは ‎<ref>…‎</ref> ; では機能きのうしないので、予測よそくする結果けっかを得えるには{{subst:#tag:ref|…}} を使つかってください。

リダイレクト

中なかでも{{#time:…|now-…}} は文中ぶんちゅうに日付ひづけを含ふくむページのリダイレクトで特とくに利便りべん性せいが高こうそうに見みえても、実用じつよう上じょうは機能きのうしません。

表ひょう内ないでのパイプ記号きごうのエスケープ

パーサー関数かんすうはウィキ記述きじゅつの表ひょう wikitable の構文こうぶんを断たち切きりパイプ記号きごう (|) に与あたえる役目やくめを変質へんしつさせ、生せいのパイプ記号きごうは単たんに変数へんすうの区切くぎり子ことして扱あつかいます。回避かいひ策さくとして過去かこにはほとんどのウィキで Template:! テンプレートを使つかい生せいのパイプ記号きごう (|) 単体たんたいのみ記しるしていたところ、MW 1.24 以降いこうはこの苦くるしい方法ほうほうに代かわって {{!}} マジックワードが使つかえます。これは見みた目めにパイプ記号きごうを MediaWiki 関数かんすうに対たいして〈不可視ふかし化か〉することで、特定とくていのページ内ないのテンプレート類るいや変数へんすうがすべて展開てんかいするまで、処理しょりの対象たいしょうとして保留ほりゅうされます。そして表ひょうの列れつや行くだりの区切くぎり子ことして解釈かいしゃくされます。代案だいあんとして生なまの HTML 形式けいしきの関数かんすうの表ひょうを使つかう方法ほうほうもあり、ただし直感ちょっかん的てきに記述きじゅつしにくくエラー発生はっせいの確かく率りつも高たかめです。

パイプ記号きごうは、平文へいぶん (解釈かいしゃくされない) 文字もじとしてエスケープすることもできます。これには HTML エンティティ | を使用しようします。

説明せつめい	入力にゅうりょく内容ないよう	結果けっか
パイプ記号きごうを表ひょうの行くだり/列れつ区切くぎりとしてエスケープ	{{!}}	\|
パイプ記号きごうをプレーンな文字もじとしてエスケープ	\|	\|

空白くうはく類るいの除去じょきょ

空白くうはく (改行かいぎょう、タブ、空白くうはくアキ) はパーサ関数かんすうの全ぜんパラメータの開始かいしから終了しゅうりょうまで除去じょきょします。これを回避かいひするには、引用いんよう符ふで囲かこんでから文字もじ列れつを比較ひかくします。

{{#ifeq: foo | foo | equal | not equal }} → equal

{{#ifeq: "foo " | " foo" | equal | not equal }} → not equal

then 部分ぶぶんおよび else 部分ぶぶんでの空白くうはくの除去じょきょを回避かいひする方法ほうほうは m:Template:If を参照さんしょうしてください。空白くうはくの代かわりに <nowiki > </nowiki> を使用しようすることもできます。

foo{{#if:|| bar }}foo → foobarfoo

foo{{#if:||<nowiki /> bar <nowiki />}}foo → foo bar foo

ただし連続れんぞくする複数ふくすうの空白くうはく文字もじはパーサにより1文字もじに圧縮あっしゅくされるため、この方法ほうほうにより処理しょりできるのは1文字もじの空白くうはく文字もじに限定げんていされます。

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

→

foo bar foo

このサンプルでは white-space: pre 書式しょしきを採用さいようしてブラウザ上じょうで非ひ表示ひょうじでも、空白くうはくスペースが保持ほじされるように強制きょうせいします。ソフトウェアにより、ブラウザに渡わたす前まえに空白くうはく文字もじが除去じょきょされるため発生はっせいします。

この挙動きょどうを回避かいひするには、ソフトウェアによって置換ちかんされないように空白くうはく類るいを   (改行かいぎょう可能かのう空白くうはく) または   (改行かいぎょう不可ふか空白くうはく、nbsp) に置換ちかんします。

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

foo{{#if:||   bar   }}foo → foo bar foo

パラメータ同士どうしの重おもみづけは同等どうとうでない点てんにご注意ちゅういください。パーサ関数かんすう ParserFunctions では、冒頭ぼうとうと末尾まつびの空白くうはくスペースは常つねに除去じょきょされます。テンプレートでは冒頭ぼうとうと末尾まつびの空白くうはくスペースは名前なまえ付つきパラメータと名前なまえをつけた名無ななしパラメータに関かんしては除去じょきょ、ただし名無ななしのままのパラメータからは除去じょきょしません :

foo{{1x|content= bar}}foo → foobarfoo

foo{{1x|1= bar}}foo → foobarfoo

foo{{1x| bar }}foo → foo bar foo

脚注きゃくちゅう

↑ 2011年ねんのr86805以前いぜんとは扱あつかいが変かわりました。
↑ phabricator.wikimedia.orgのExtParserFunctions.php を参照さんしょうしてください。

[1] PHP 5.1.0 以降いこうおよび rev:45208 が必要ひつよう

[2] Y と等ひとし値ちになるが、ISO 週番しゅうばん号ごう (W) が前月ぜんげつもしくは次月しづきの場合ばあい、年としで代用だいよう。

[3] 注ちゅう1の場合ばあいが未み記入きにゅうだと、リテラルo を出力しゅつりょく。

[4] 2011年ねんのr86805以前いぜんとは扱あつかいが変かわりました。

[5] ricator.wikimedia.orgのExtParserFunctions.php を参照さんしょうしてください。

[note 1]

[note 2]

[note 3]

[1]

[2]

v t e パーサー関数かんすう
すべて	A {{#anchorencode }} B {{#babel }} {{#basepagename }} {{#basepagenamee }} C {{#canonicalurl }} {{#canonicalurle }} {{#categorytree }} {{#coordinates }} D {{#defaultsort }} {{#displaytitle }} E {{#expr }} F {{#filepath }} {{#formatdate }} {{#formatnum }} {{#fullpagename }} {{#fullpagenamee }} {{#fullurl }} {{#fullurle }} G {{#gender }} {{#grammar }} I {{#if }} {{#ifeq }} {{#iferror }} {{#ifexist }} {{#ifexpr }} {{#int }} {{#invoke}} L {{#language }} {{#lc }} {{#lcfirst }} {{#localurl }} {{#localurle }} {{#lqtpagelimit }} {{#lst }} {{#lstx }} N {{#namespace }} {{#namespacee }} {{#namespacenumber }} {{#ns }} {{#nse }} {{#numberingroup }} {{#numberofactiveusers }} {{#numberofadmins }} {{#numberofarticles }} {{#numberofedits }} {{#numberoffiles }} {{#numberofpages }} {{#numberofusers }} {{#numberofviews }} P {{#padleft }} {{#padright }} {{#pagename }} {{#pagenamee }} {{#pagesincategory }} {{#pagesize }} {{#plural }} {{#property}} {{#protectionlevel }} R {{#rel2abs }} {{#rootpagename }} {{#rootpagenamee }} S {{#special }} {{#speciale }} {{#statement}} {{#subjectpagename }} {{#subjectpagenamee }} {{#subjectspace }} {{#subjectspacee }} {{#subpagename }} {{#subpagenamee }} {{#switch }} T {{#tag }} {{#talkpagename }} {{#talkpagenamee }} {{#talkspace }} {{#talkspacee }} {{#time }} {{#timel }} {{#titleparts }} {{#translation }} {{#translationdialog }} U {{#uc }} {{#ucfirst }} {{#urlencode }} {{#useliquidthreads }}
関連かんれん項目こうもく	Help:Extension:ParserFunctions Help:テンプレート内ないでのパーサー関数かんすうパーサー拡張かくちょう機能きのうのタグ Parser function hooks
このナビゲーションボックスを翻訳ほんやく