![]() | Hinweis: Wenn Du diese Seite bearbeitest, stimmst Du zu, dass Dein Beitrag unter der [CC0] veröffentlicht wird. Mehr Informationen findest du auf derPublic Domain Hilfeseite. | ![]() |
Die ErweiterungParserFunctions bietet zusätzlicheParserfunktionen, um die "Magic words" zu ergänzen, die es in MediaWiki bereits gibt.(Siekann konfiguriert werden, um zusätzliche Parser-Funktionen zur Vearbeitung von Strings zur Verfügung zu stellen, diese sindanderswo dokumentiert.)Alle Funktionen, die diese Erweiterung unterstützt, haben folgende Form:
{{#Funktionsname:Parameter 1 |Parameter 2 |Parameter 3 ... }}
Art | Operatoren |
---|---|
Gruppieren (Klammern) | ( ) |
Zahlen | 1234.5 e (2.718) pi (3.142) |
Binärer Operatore unäre+ ,- | |
Unäre Operatoren | not ceil trunc floor abs exp ln sin cos tan acos asin atan sqrt |
Binäre Operatoren | ^ |
* / div mod fmod | |
+ - | |
Runden | round |
Logische Operatoren | = != <> > < >= <= |
and | |
or |
Diese Funktion berechnet einen mathematischen Ausdruck und gibt den errechneten Wert aus.Diese Funktion steht über diemw.ext.ParserFunctions.expr
-Funktion auch inScribunto zur Verfügung.
{{#expr:Ausdruck }}
Einfaches Beispiel:
{{#expr: 1 + 1}}
→2Die verfügbaren Operatoren sind rechts aufgelistet, in der Reihenfolge ihrer Anwendung. Siehe [[Manual:Expr parser function syntax|Help:Calculation]] (englisch) für nähere Details über die Funktion der einzelnen Operatoren.Genauigkeit und Format des ausgegebenen Resultats kann je nach Betriebssystem des Servers, auf dem das Wiki läuft, und dem Zahlenformat der Sprache der Umgebung abweichen.
Bei Nutzung derBooleschen Algebra ergibt 0 immerfalse
und jeder andere Wert, ob positiv oder negativ, immertrue
:
{{#expr: 1 and -1}}
→1{{#expr: 1 and 0}}
→0{{#expr: 1 or -1}}
→1{{#expr: -1 or 0}}
→1{{#expr: 0 or 0}}
→0Ein leerer eingegebener Ausdruck erzeugt eine leere Ausgabe. Ungültige Ausdrücke erzeugen eine von mehreren möglichen Fehlermeldungen, die durch Nutzung der Funktion#iferror
abgefangen werden können:
{{#expr:}}
→{{#expr: 1+}}
→Expression error: Missing operand for +.{{#expr: 1 =}}
→Expression error: Missing operand for =.{{#expr: 1 foo 2}}
→Expression error: Unrecognized word "foo".Die Reihenfolge der Additions- und Subtraktionsoperanden vor oder nach einer Zahl ist bedeutend und kann als positiver oder negativer Wert eingesetzt werden anstelle eines Operanden mit fehlerhafter Eingabe:
{{#expr: +1}}
→1{{#expr: -1}}
→-1{{#expr: + 1}}
→1{{#expr: - 1}}
→-1Beachten Sie, dass Sie bei Verwendung der Ausgabe von magischen Wörtern diese im Rohformat formatieren müssen, um Kommas zu entfernen und die Ziffern zu übersetzen.Beispielsweise führt {{NUMBEROFUSERS}} zu 18.137.928, wobei wir 18137928 wollen, das mit{{formatnum:{{NUMBEROFUSERS}}|R}}
abgerufen werden kann.Dies ist besonders wichtig in einigen Sprachen, in denen Ziffern übersetzt werden.Beispielsweise erzeugt {{NUMBEROFUSERS}} in Bengali ৩০,০৬১.
{{#expr:{{NUMBEROFUSERS}}+100}}
→ 118.137{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}}
→18138028![]() | Der Operatormod ergibt bei einigen Werten des zweiten Parameters falsche Ergebnisse:
|
Rundet die Zahl links auf ein Vielfaches von 1/10 hoch den gekürzten Wert der Zahl rechts.
Um auf- oder abzurunden benutzeceil
bzw.floor
.
Testfall | Resultat | Rundungsmethode | ||
---|---|---|---|---|
{{#expr: 1/3 round 5 }} | 0.33333 | Die endgültige Zahl ist <5, deshalb erscheint keine sichtbare Rundung (0.333333… → 0.33333) | ||
{{#expr: 1/6 round 5 }} | 0.16667 | Die endgültige Zahl ist >=5, deshalb wird sie aufgerundet (0.166666… → 0.16667) | ||
{{#expr: 8.99999/9 round 5 }} | 1 | Das Ergebnis wird noch einmal in der letzten Ziffer aufgerundet, was zusätzliche Rundung ergibt (0.999998… → 1.00000 → 1) | ||
{{#expr: 1234.5678round -2 }} | 1200 | Gerundet auf die nächsten 100, da negative Werte links vom Dezimalkomma (hier Punkt) runden | ||
{{#expr: 1234.5678round 2 }} | 1234.57 | Gerundet auf die nächsten 100, da positive Werte rechts vom Dezimalkomma (hier Punkt) runden | ||
{{#expr: 1234.5678 round 2.3 }} | 1234.57 | Dezimalstellen in der Rundungsangabe ergeben keinen Unterschied im gerundeten Ergebnis | ||
{{#expr:trunc 1234.5678 }} | 1234 | Dezimalstellen abgeschnitten | ||
Auf die nächste Ganzzahl (integer) runden | ||||
{{#expr: 1/3round 0 }} | 0 | Abrunden auf dienächste Ganzzahl, hier Null | ||
{{#expr: 1/2round 0 }} | 1 | Aufrunden auf die nächste Ganzzahl, hier Eins | ||
{{#expr: 3/4round 0 }} | 1 | Aufrunden auf die nächste Ganzzahl, hier Eins | ||
{{#expr: -1/3round 0 }} | -0 | Aufrunden auf die nächste Ganzzahl, hier Null | ||
{{#expr: -1/2round 0 }} | -1 | Abrunden auf die nächste Ganzzahl, hier -1 | ||
{{#expr: -3/4round 0 }} | -1 | Abrunden auf die nächste Ganzzahl, hier -1 | ||
Auf- oder Ab-Runden mitceil undfloor | ||||
{{#expr:ceil(1/3) }} | 1 | Aufrunden auf die nächstegrößere Ganzzahl, hier 1 | ||
{{#expr:floor(1/3) }} | 0 | Abrunden auf die nächstekleinere Ganzzahl, hier Null | ||
{{#expr:ceil(-1/3) }} | -0 | Aufrunden auf die nächstgrößere Ganzzahl, hier Null | ||
{{#expr:floor(-1/3) }} | -1 | Abrunden auf die nächst kleinere Ganzzahl, hier -1 | ||
{{#expr:ceil 1/3 }} | 0.33333333333333 | Nicht gerundet, da 1 schon eine Ganzzahl ist
| ||
Rounding large numbers | ||||
{{#expr: 1e-92 round 400 }} | 1.0E-92 | Runden auf eine sehr große Stellenzahl ergibt unendlich. Daher wird der Ausgangswert ohne unendlich zurückgegeben. | ||
{{#expr: 1e108 round 200 }} | 1.0E+108 | Genau wie oben. |
Die Ausdrücke funktionieren nur mit zahlenähnlichen Werten, denn sie können nicht Funktionen oder Zeichen vergleichen.#ifeq kann stattdessen verwendet werden.
{{#expr: "a" = "a"}}
→Expression error: Unrecognized punctuation character """.{{#expr: a = a}}
→Expression error: Unrecognized word "a".{{#ifeq: a| a| 1| 0}}
→1Diese Funktion wertet einen Teststring aus und stellt fest, ob er leer ist oder nicht. Ein Teststring, der nur Leerzeichen enthält, wird als leer betrachtet.
{{#if: Teststring| Wert, wenn der Testring nicht leer ist| Wert, wenn der Teststring leer ist (oder nur aus Leerzeichen besteht)}}
{{#if: erster Parameter| zweiter Parameter| dritter Parameter}}
Diese Funktion testet zuerst, ob der erste Parameter nicht leer ist. Wenn der erste Parameter nicht leer ist, zeigt die Funktion den zweiten Parameter. Wenn der erste Parameter leer ist oder nur Weißraumzeichen enthält (Leerzeichen, neue Zeilen etc.), wird der dritte Parameter ausgegeben.
{{#if:| yes| no}}
→no{{#if: string| yes| no}}
→yes{{#if: | yes| no}}
→yes{{#if:| yes| no}}
→noDer Testausdruck wird immer als reiner Text interpretiert, also werden mathematische Ausdrücke nicht evaluiert:
{{#if: 1==2| yes| no}}
→yes{{#if: 0| yes| no}}
→yesDer letzte Parameter (false) kann weggelassen werden:
{{#if: foo| yes}}
→ yes{{#if:| yes}}
→{{#if: foo|| no}}
→Die Funktion kann verschachtelt sein. Verschachteln Sie dazu die innere#if
-Funktion in ihrer vollständigen Form anstelle eines Parameters der einschließenden#if
-Funktion. Bis zu sieben Verschachtelungsebenen sind möglich, obwohl dies vom Wiki oder einem Speicherlimit abhängen kann.
{{#if:Teststring|Wert, wenn der Teststring nicht leer ist|{{#if:Teststring|Wert, wenn der Teststring nicht leer ist|Wert, wenn der Teststring leer ist (oder nur aus Leerzeichen besteht)}}}}
Sie können auch einen Parameter als Teststring in Ihrer#if
-Anweisung verwenden. Sie müssen sicherstellen, dass Sie das|
(Pipe-Symbol) nach dem Namen der Variablen hinzufügen.(Wenn der Parameter also keinen Wert hat, wird er zu einer leeren Zeichenfolge anstelle der Zeichenfolge „{{{1}}}
“ ausgewertet.)
{{#if:{{{1|}}}|Du hast Text in der Variable 1 eingegeben|Es gibt keinen Text in der Variable 1}}
SieheHelp:Parserfunktionen in Vorlagen für weitere Beispiele zu dieser Parserfunktion.
Diese Parserfunktion vergleicht zwei Eingabezeichenfolgen, bestimmt, ob sie identisch sind, und gibt basierend auf dem Ergebnis eine von zwei Zeichenfolgen zurück.Wenn mehr Vergleiche und Ausgabestrings erforderlich sind, ziehen Sie die Verwendung von#switch
in Betracht.
{{#ifeq:string 1 |string 2 |value if identical |value if different }}
Wenn beide Ausdrücke gültige numerische Werte sind, werden die Ausdrücke zahlenmäßig verglichen:
{{#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}}
→equalAndernfalls wird der Vergleich textmäßig vollzogen, dieser Vergleich beachtet die Groß- und Kleinschreibung:
{{#ifeq: foo| bar| equal| not equal}}
→not equal{{#ifeq: foo| Foo| equal| not equal}}
→not equal{{#ifeq: "01"| "1"| equal| not equal}}
→not equal (vergleiche mit dem ähnlichen Beispiel oben, aber ohne Anführungszeichen){{#ifeq: 10^3| 1000| equal| not equal}}
→not equal (vergleiche mit dem ähnlichen Beispiel oben, wo#expr
eine gültige erste Zahl anzeigt)Betrachten Sie als praktisches Beispiel ein vorhandenestemplateTemplate:Timer
, das den Parser verwendet, um zwischen zwei Standardzeiten zu wählen, kurz und lang.Es nimmt den Parameter als erste Eingabe, um ihn mit der Zeichenfolge „short“ zu vergleichen – es gibt keine Konvention für die Reihenfolge, aber es ist einfacher zu lesen, wenn der Parameter an erster Stelle steht.Der Vorlagenquelltext sieht so aus:
{{#ifeq:{{{1|}}}| short| 20| 40}}
folgendes ergibt sich:
{{timer|short}}
→20{{timer|20}}
→40{{timer}}
→40![]() | Bei Verwendung innerhalb einer Parser-Funktion müssen alle Parser-Tags und andere Parser-Funktionen vorübergehend durcheinen eindeutigen Code ersetzt werden. Dies wirkt sich auf Vergleiche aus:
|
![]() | Wörtliche Vergleiche mitpage-name magic words können je nach Site-Konfiguration fehlschlagen. Zum Beispiel kann {{FULLPAGENAME}}, je nach Wiki, den ersten Buchstaben groß schreiben und alle Unterstriche durch Leerzeichen ersetzen. Um dies zu umgehen, wenden Sie das Magische Wort auf beide Parameter an:
|
Diese Funktion überprüft, ob der eingegebene Ausdruck einen Fehler erzeugt. Die Funktion gibttrue
aus, wenn der Ausdruck ein HTML-Objekt mitclass="error"
enthält, wie es z.B. von den Funktionen#expr
,#time
und#rel2abs
bei Fehlern ausgegeben wird. AuchVorlagenfehler wie Rekursionsschleifen werden erkannt.
{{#iferror:test string |value if error |value if correct }}
Eine oder beide Rückgabezeichenfolgen können weggelassen werden. Wenn die Zeichenfolgecorrect
weggelassen wird, wirdtest string
ausgegeben, sofern sie nicht fehlerhaft ist. Wenn auch die Zeichenfolgeerror
weggelassen wird, wird bei einem Fehler eine leere Zeichenfolge zurückgegeben:
{{#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:<strongclass="error">a</strong>| error| correct}}
→errorManche Fehler können die Zuweisung einer Kategorie zur Fehlerverfolgung verursachen. Die Verwendung von{{#iferror:}}
kann dies nicht unterdrücken.
Diese Funktion berechnet einen mathematischen Ausdruck und gibt – abhängig vom Wahrheitswert des Ergebnisses – einen von zwei Werten aus.
{{#ifexpr:expression |value if true |value if false }}
Für den Ausdruckexpression
gelten dabei dieselben Regeln wie bei#expr
. Nach der Berechnung überprüft die Funktion, ob das Ergebnis ungleich Null ist (Boolesch:true = 1/false = 0).
Eine leere Eingabe führt zur Ausgabefalse
:
{{#ifexpr:| yes| no}}
→noWie gesagt führt das Ergebnis Null zur Ausgabefalse
, jeder andere Wert hingegen zur Ausgabetrue
. Es handelt sich also praktisch um eine Kombination von#ifeq
und#expr
:
{{#ifeq: {{#expr:expression }} | 0 |value if false |value if true }}
außer für einen leeren oder falsch eingegebenen Ausdruck (eine Fehlermeldung wird wie ein leerer Ausdruck behandelt; es ist nicht gleich Null, also bekommen wirvalue if true
).
{{#ifexpr: =| yes| no}}
→Expression error: Unexpected = operator.vergleichend
{{#ifeq:{{#expr: =}}| 0| no| yes}}
→ yesBeide Parameter können auch weggelassen werden, in diesem Fall wird jeweils nichts ausgegeben:
{{#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}}
→Boolesche Operatoren von Gleichheits- oder Ungleichheitsoperatoren werden unterstützt.
{{#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![]() | Die Ergebnisse von numerischen Vergleichen mit#ifexpr stimmen nicht immer mit denen von#ifeq und#switch überein. Die beiden letzteren sind genauer als#ifexpr und liefern keine gleichwertigen Ergebnisse.Betrachten Sie diese Vergleiche mit geänderter Endziffer:
Da PHP, das in
Mit der anderen Ziffer ist das Ergebnis von gleich eigentlich falsch. Dieses Verhalten in#ifexpr wird verursacht, weil MediaWiki Literalzahlen in Ausdrücken in den Typ Float umwandelt, was für große Ganzzahlen wie diese eine Rundung beinhaltet. |
Diese Funktion überprüft, ob eine bestimmte Seite im Wiki existiert, und gibt je nachdem einen von zwei Parametern aus.
{{#ifexist:page title |value if exists |value if doesn't exist }}
Die Funktion ergibttrue
, wenn die Seite existiert, ob sie Inhalt enthält, sichtbar leer ist (enthält Metadaten wie Kategorienlinks odermagic words, aber nicht sichtbar content), ist leer oder ist eineredirect. Nur Seiten, die mit einem Redlink versehen sind, werden alsfalse
ausgewertet, auch wenn die Seite früher existierte, aber gelöscht wurde.
{{#ifexist: Help:Extension:ParserFunctions/de | exists | doesn't exist }}
→exists{{#ifexist: XXHelp:Extension:ParserFunctions/deXX | exists | doesn't exist }}
→doesn't existDie Funktion ergibttrue
fürSystemnachrichten, die angepasst wurden, und fürSpezialseiten, die von der Software definiert wurden.
{{#ifexist: Special:Watchlist | exists | doesn't exist }}
→exists{{#ifexist: Special:CheckUser | exists | doesn't exist }}
→exists (weil die ErweiterungCheckuser in diesem Wiki installiert ist){{#ifexist: MediaWiki:Copyright | exists | doesn't exist }}
→doesn't exist (weilMediaWiki:Copyright noch nicht bearbeitet wurde)Vor MediaWiki 1.45 erscheint eine Seite, die von einer anderen Seite mit#ifexist:
überprüft wurde, in derSpecial:WhatLinksHere-Liste.Wenn also der Code{{#ifexist:Foo }}
aktuell auf dieser Seite (Help:Extension:ParserFunctions/de) enthalten wäre, dann würdeSpecial:WhatLinksHere/Foo die Seite Help:Extension:ParserFunctions/de aufführen.
In Wikis, die eine gemeinschaftliche Bilddatenbank nutzen (z.B. Wikimedia Commons), kann#ifexist:
benutzt werden, um zu überprüfen, ob Dateien im lokalen Wiki oder in der externen Bilddatenbank hochgeladen wurden.
{{#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 }}
→existsWenn die lokale Bildbeschreibungsseite angelegt wurde, ist das Resultat für all diese Testsexistiert.
#ifexist:
funktioniert nicht bei Interwiki-Links.
#ifexist:
wird als „aufwendige Parserfunktion“ eingestuft; nur eine bestimmte Anzahl von ihnen kann auf einer bestimmten Seite eingebunden werden (Funktionen in eingebundenen Vorlagen eingeschlossen).Wenn dieses Limit überschritten wird, geben weitere#ifexist:
-Funktionen automatisch falsch zurück, unabhängig davon ob die Zielseite existiert oder nicht, und die Seite wird inCategory:Pages with too many expensive parser function calls eingeordnet.Der Name derWartungskategorie kann von der Inhaltssprache deines Wikis abhängen.
Für einige Anwendungsfälle ist es möglich, den Ifexist-Effekt mit CSS zu emulieren, indem die Selektorena.new
(um Links zu nicht existierenden Seiten auszuwählen) odera:not(.new)
(um Links zu bestehenden Seiten auszuwählen) verwendet werden.Da außerdem die Anzahl der teuren Parser-Funktionen, die auf einer einzelnen Seite verwendet werden können, durch$wgExpensiveParserFunctionLimit
gesteuert wird, kann man das Limit bei Bedarf auch in LocalSettings.php erhöhen.
Vor MediaWiki 1.45 erschient eine Seite, die nicht existiert und auf die Verwendung von #ifexist geprüft wurde, auf denWanted Pages.SieheT14019 für den Grund undw:Template:Linkless existiert für eine Problemumgehung.
Diese Funktion wandelt einen relativen Dateipfad in einen absoluten Dateipfad um.
{{#rel2abs:path }}
{{#rel2abs:path |base path }}
Innerhalb derpath
-Eingabe gilt die folgende Syntax:
.
→ aktuelle Ebene..
→ Eine Ebene höher/foo
→ Eine Ebene tiefer in die Unterseite /fooWennbase path
nicht angegeben ist, wird stattdessen der vollständige Seitenname der Seite verwendet:
{{#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/barUngültige Syntax wie/.
oder/./
wird ignoriert.Da nicht mehr als zwei aufeinanderfolgende Punkte erlaubt sind, können Sequenzen wie diese verwendet werden, um aufeinanderfolgende Anweisungen zu trennen:
{{#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 }}
→Fehler: Ungültige Pfadtiefe: „Help:Foo/bar/baz/../../../../quok“ (Zugriff auf einen Knotenpunkt oberhalb des Hauptknotenpunktes ist empfohlen)Für eine vergleichbare Gruppe an Funktionen siehe auchHilfe:Magische Wörter#URL-Daten.Unterstützte ParserFunktionen beinhalten: 'localurl:', 'fullurl:', 'anchorencode:', etc.
Siehe auch:w:Help:Switch parser function
Diese Funktion vergleicht einen Eingabewert mit mehreren Testfällen und gibt eine zugehörige Zeichenfolge zurück, wenn eine Übereinstimmung gefunden wird.
{{#switch:comparison string |case =result |case =result |... |case =result |default result}}
Beispiele:
{{#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 mit partiellen Transklusions-Tags kann sich auf eine Konfigurationsdatei auswirken, die es einem Editor, der mit Template-Codierung nicht vertraut ist, ermöglicht, konfigurierbare Elemente anzuzeigen und zu bearbeiten.
Dasdefault result
wird zurückgegeben, wenn keincase
-String mit demcomparison string
übereinstimmt:
{{#switch: test| foo= Foo| baz= Baz| Bar}}
→ BarIn dieser Syntax muss das Standardergebnis der letzte Parameter sein und darf kein rohes Gleichheitszeichen (ein Gleichheitszeichen ohne{{}}
) enthalten.Wenn dies der Fall ist, wird dies als Fallvergleich behandelt, und es wird kein Text angezeigt, wenn keine Fälle übereinstimmen.Dies liegt daran, dass der Standardwert nicht definiert wurde (weil er leer ist).Im Falle einer Übereinstimmung jedoch wird der zugehörige String zurückgegeben.
{{#switch: test| Bar| foo= Foo| baz= Baz}}
→{{#switch: test| foo= Foo| baz= Baz| B=ar}}
→{{#switch: test| test= Foo| baz= Baz| B=ar}}
→ FooAlternativ kann das Standardergebnis explizit mit einercase
-Zeichenfolge von "#default
" deklariert werden.
{{#switch:comparison string |case =result |case =result |... |case =result | #default =default result}}
Auf diese Weise deklarierte Standardergebnisse können an beliebiger Stelle innerhalb der Funktion platziert werden:
{{#switch: test| foo= Foo| #default= Bar| baz= Baz}}
→ BarWenn der Parameterdefault
weggelassen wird und keine Übereinstimmung gefunden wird, wird keinresult
zurückgegeben:
{{#switch: test| foo= Foo| baz= Baz}}
→Es ist möglich, dass Werte durchfallen, bei denen mehrerecase
-Strings denselbenresult
-String zurückgeben. Dadurch wird Doppelarbeit minimiert.
{{#switch:comparison string |case1 =result1 |case2 |case3 |case4 =result234 |case5 =result5 |case6 |case7 =result67 | #default =default result}}
Hier geben die Fälle 2, 3 und 4 alleresult234
zurück; Fall 6 und 7 geben beideresult67
zurück.Das "#default =
" im letzten Parameter kann im obigen Fall weggelassen werden.
Die Funktion kann mit Parametern als Teststring verwendet werden.In diesem Fall ist es nicht erforderlich, die Pipe nach dem Parameternamen zu platzieren, da es sehr unwahrscheinlich ist, dass Sie die Zeichenfolge „{{{parameter name}}}
“ als Groß-/Kleinschreibung festlegen.(Dies ist der Wert, auf den der Parameter standardmäßig gesetzt wird, wenn die Pipe nicht vorhanden ist und der Parameter nicht vorhanden ist oder keinen Wert hat.SieheHelp:Parserfunktionen in Vorlagen.)
{{#switch:{{{1}}}| foo= Foo| baz= Baz| Bar}}
Wenn im obigen Fall{{{1}}}
gleichfoo
ist, gibt die FunktionFoo
zurück.Wenn es gleichbaz
ist, gibt die FunktionBaz
zurück.Wenn der Parameter leer ist oder nicht existiert, gibt die FunktionBar
zurück.
Wie im obigen Abschnitt können Fälle kombiniert werden, um ein einziges Ergebnis zu erhalten.
{{#switch:{{{1}}}| foo| zoo| roo= Foo| baz= Baz| Bar}}
Wenn hier{{{1}}}
gleichfoo
,zoo
oderroo
ist, gibt die FunktionFoo
zurück.Wenn es gleichbaz
ist, gibt die FunktionBaz
zurück.Wenn der Parameter leer ist oder nicht existiert, gibt die FunktionBar
zurück.
Außerdem kann das Standardergebnis weggelassen werden, wenn Sie nichts zurückgeben möchten, wenn der Testparameterwert keinem der Fälle entspricht.
{{#switch:{{{1}}}| foo= Foo| bar= Bar}}
In diesem Fall gibt die Funktion eine leere Zeichenfolge zurück, es sei denn,{{{1}}}
existiert und ist gleichfoo
oderbar
, in diesem Fall gibt sieFoo
bzw.Bar
zurück.
Dies hat den gleichen Effekt wie das Deklarieren des Standardergebnisses als leer.
{{#switch:{{{1}}}| foo| zoo| roo= Foo| baz= Baz|}}
Wenn Sie aus irgendeinem Grund entscheiden, einen Fall als "{{{parameter name}}}
" festzulegen, gibt die Funktion das Ergebnis dieses Falls zurück, wenn der Parameter nicht existiert oder keinen Wert hat.Der Parameter müsste vorhanden sein und einen anderen Wert als die Zeichenfolge "{{{parameter name}}}
" haben, um das Standardergebnis der Funktion zurückzugeben.
{{{1}}}
nicht existiert oder leer ist):{{#switch:{{{1}}}|{{{1}}} = Foo| baz= Baz| Bar}}
→ Foo{{{1}}}
den Wert "test
" hat):{{#switch:{{{1}}}|{{{1}}} = Foo| baz= Baz| Bar}}
→ Bar{{{1}}}
den Wert "{{{1}}}
" hat):{{#switch:{{{1}}}|{{{1}}} = Foo| baz= Baz| Bar}}
→ FooIn diesem hypothetischen Fall müssten Sie die Pipe zum Parameter ({{{1|}}}
) hinzufügen.
Wie bei#ifeq
wird der Vergleich numerisch durchgeführt, wenn sowohl die Vergleichszeichenfolge als auch die zu testende Fallzeichenfolge numerisch sind; oder als case-sensitive Zeichenfolge ansonsten:
{{#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}}
→CEincase
-String kann leer sein:
{{#switch:|= Nothing| foo= Foo| Something}}
→NothingSobald eine Übereinstimmung gefunden wurde, werden nachfolgendecases
ignoriert:
{{#switch: b| f= Foo| b= Bar| b= Baz|}}
→Bar![]() | Numerische Vergleiche mit#switch und#ifeq sind nicht gleichbedeutend mit Vergleichen in Ausdrücken (siehe auch oben):
|
"Case"-Strings dürfen keine rohen Gleichheitszeichen enthalten. Um dies zu umgehen, verwenden Sie das magische Wort{{=}}, oder ersetzen Sie das Gleichheitszeichen durch den HTML-Code=
.
Beispiel:
Sie schreiben | Sie erhalten |
---|---|
{{#switch: 1=2| 1=2 = raw| 1<nowiki>=</nowiki>2 = nowiki| 1{{=}}2 = template| default}} | template |
{{#switch: 1=2| 1=2= html| default}} | html |
#switch
kann verwendet werden, um dieExpansionstiefe zu reduzieren.
Zum Beispiel:
{{#switch:{{{1}}}|condition1=branch1|condition2=branch2|condition3=branch3|branch4}}
ist gleichbedeutend mit
{{#ifeq:{{{1}}}|condition1|branch1|{{#ifeq:{{{1}}}|condition2|branch2|{{#ifeq:{{{1}}}|condition3|branch3|branch4}}}}}}
d.h. tief verschachtelt, linear:
{{#ifeq:{{{1}}}|condition1|<!--then-->branch1|<!--else-->{{#ifeq:{{{1}}}|condition2|<!--then-->branch2|<!--else-->{{#ifeq:{{{1}}}|condition3|<!--then-->branch3|<!--else-->branch4}}}}}}
Andererseits könnte der Switch-Ersatz kompliziert/unpraktisch für IFs sein, die in beiden Zweigen verschachtelt sind (gezeigt mit Einrückungsalternativen, auf beiden Seiten eingerückt), wodurch ein vollständig symmetrischer Baum entsteht:
{{#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}}}}}}
Code | Beschreibung | Aktuelle Ausgabe (Purge this page's cache to update) |
---|---|---|
Jahr | ||
Y | Jahreszahl mit 4 Stellen | 2025 |
y | Jahreszahl mit 2 Stellen | 25 |
L | 1 für ein Schaltjahr, 0 für andere Jahre. | 0 |
o [note 1] | ISO-8601-Jahr für die angegebene Woche.[note 2] | 2025[note 3] |
Monat | ||
n | Monatszahl ohne führende Null. | 7 |
m | Monatszahl mit führender Null. | 07 |
M | Abkürzung des Monatsnamens in der Seitensprache. | Jul. |
F | Vollständiger Monatsname in der Seitensprache. | Juli |
xg | Gibt den vollständigen Monatsnamen in derGenitiv-Form der Seitensprache aus, der zwischen Genitiv- undNominativ-Formen unterscheidet. Diese Option ist für vieleslawische Sprachen wie Polnisch, Russisch, Weißrussisch, Tschechisch, Slowakisch, Slowenisch, Ukrainisch usw. nützlich. | Für Polnisch:{{#time:F Y|June 2010|pl}} → czerwiec 2010(Nominativ) {{#time:d xg Y|20 June 2010|pl}} → 20 czerwca 2010(Genitiv) |
Tag oder Monat des Jahres | ||
j | Tag des Monats ohne führende Null. | 18 |
d | Tag des Monats mit führender Null. | 18 |
z | Tag des Jahres (Januar 1 = 0).![]() | 198 |
Woche und Wochentag | ||
W | ISO-8601-Wochennummer mit führender Null. | 29 |
N | ISO-8601-Wochentag (Montag = 1, Sonntag = 7). | 5 |
w | Ziffer des Wochentags (Sonntag = 0, Samstag = 6). | 5 |
D | Abkürzung für den Wochentag. Selten internationalisiert. | Fr |
l | Vollständiger Wochentagsname. Selten internationalisiert. | Freitag |
Stunde | ||
a | "am" am Morgen (00:00:00 → 11:59:59), "pm" ab Mittag (12:00:00 → 23:59:59). | pm |
A | Schreibweise in Großbuchstaben vona oben. | PM |
g | Stunde im 12-Stunden-Format ohne führende Null. | 7 |
h | Stunde im 12-Stunden-Format mit führender Null. | 07 |
G | Stunde im 24-Stunden-Format ohne führende Null. | 19 |
H | Stunde im 24-Stunden-Format mit führender Null. | 19 |
Minuten und Sekunden | ||
i | Minuten nach der Stunde mit führender Null. | 48 |
s | Sekunden nach der Minute mit führender Null. | 48 |
U | Unixzeit. Sekunden seit 1. Januar 1970 00:00:00 GMT. | 1752868128 |
Zeitzone (nach1.22wmf2) | ||
e | Zeitzonen-Identifikator. | UTC |
I | Ob das Datum sich in der Sommerzeit (Zeitumstellung) befindet. | 0 |
O | Unterschied zur Greenwich-Zeit (GMT) | +0000 |
P | Unterschied zur Greenwich Zeit (GMT), mit Doppelpunkt | +00:00 |
T | Zeitzonen-Abkürzung. | UTC |
Z | Zeitzonen-Abweichung in Sekunden. | 0 |
Sonstiges | ||
t | Anzahl der Tage im aktuellen Monat. | 31 |
c | ISO-8601-formatiertes Datum, entsprichtY-m-d"T"H:i:s+00:00 . | 2025-07-18T19:48:48+00:00 |
r | RFC 5322-formatiertes Datum, entsprichtD, j M Y H:i:s +0000 , mit nicht internationalisierten Wochentags- und Monatsnamen. | Fri, 18 Jul 2025 19:48:48 +0000 |
Nicht-Gregorianische Kalender | ||
Islamisch | ||
xmj | Tag des Monats. | 22 |
xmF | Vollständiger Monatsname. | Muharram |
xmn | Monatszahl. | 1 |
xmY | Vollständiges Jahr. | 1447 |
Iranisch (Jalaly) | ||
xit | Anzahl der Tage im Monat. | 31 |
xiz | Tag des Jahres. | 119 |
xij | Tag des Monats. | 27 |
xiF | Vollständiger Monatsname. | Tir |
xin | Monatszahl. | 4 |
xiY | Vollständiges Jahr. | 1404 |
xiy | Jahreszahl mit 2 Stellen. | 04 |
Hebräisch | ||
xjj | Tag des Monats. | 22 |
xjF | Vollständiger Monatsname. | Tamuz |
xjt | Anzahl der Tage im Monat. | 29 |
xjx | Genitivform des Monatsnamen. | Tamuz |
xjn | Monatszahl. | 10 |
xjY | Vollständiges Jahr. | 5785 |
Thai solar | ||
xkY | Vollständiges Jahr imSuriyakati-Kalender.![]() | 2568 |
Jahr nach dem Minguo-/Juche-Kalender | ||
xoY | Vollständiges Jahr. | 114 |
Japanisches "nengo" | ||
xtY | Vollständiges Jahr. | 令和7 |
Flags | ||
xn | Formatieren Sie den nächsten numerischen Code als reine ASCII-Zahl. | In Hindi erzeugt{{#time:H, xnH}} ०६, 06. |
xN | Wiexn , aber als umgeschaltetes Flag, das bis zum Ende des Strings oder bis zum nächsten Auftreten vonxN im String bestehen bleibt. | |
xr | Formatieren Sie die nächste Zahl als römische Zahl. Funktioniert nur für Zahlen bis zu 10.000 (bis zu 3.000 vor MediaWiki 1.20). | {{#time:xrY}} → MMXXV |
xh | Formatieren Sie die nächste Zahl als hebräische Ziffer. | {{#time:xhY}} → ב'כ"ה |
Dies Parserfunktion nimmt ein Datum und/oder eine Zeit (im Gregorianischen Kalender) und formatiert es gemäß der gegebenen Syntax. Eine Datum/Zeit-Einheit kann bestimmt werden, der Standardwert ist der Wert desmagischen Worts{{CURRENTTIMESTAMP}}
– d.h. die Zeit, als die Seite zuletzt in HTML übersetzt wurde.
{{#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 }}
Die Liste der gültigen Formate ist der Tabelle rechts zu entnehmen.Jedes Zeichen im formatierten String, das nicht erkannt wird, wird unverändert ausgegeben; dies betrifft auch Leerzeichen (das System braucht diese nicht für das Interpretieren des Codes).Wenn im formatierten String kein Zeichen erkannt wird und das Datums-/Uhrzeitobjekt fehlerfrei ist, wird die formatierte String als Ausgabe zurückgegeben.Es gibt zwei Wege, Zeichen innerhalb des Formatierungs-Strings zu umgehen:
Zusätzlich wird der Digraphxx
als einzelnes buchstäbliches "x" interpretiert.
Da sich die Liste der Formatierungscodes weiter entwickelt (mit Unterstützung neuer Kalender oder neuer Datumsfelder, die anders berechnet und formatiert werden), sollten Sie alle Literalzeichen (nicht nur ASCII-Buchstaben, die derzeit von Formatierungscodes verwendet werden) mit Escapezeichen versehen, die übergeben werden müssen unverändert durch.
Leider wird das einfache ASCII-Anführungszeichen derzeit noch nicht als einfache Alternative zum Markieren von wörtlichem Text zu den derzeit unterstützten doppelten ASCII-Anführungszeichen erkannt (z , C++...) und Backslashes (die auch in String-Konstanten maskiert werden müssen, die von vielen Sprachen verwendet werden, darunter JSON, C, C++, PHP, JavaScript, Lua).Sie können also immer noch kein wörtliches doppeltes Anführungszeichen einbetten, ohne es mit einem Backslash zu umgehen (oder Sie können stattdessen andere geschweifte, eckige oder quadratische Anführungszeichen verwenden).
{{#time: Y-m-d}}
→2025-07-18{{#time:[[Y]] m d}}
→2025 07 18{{#time:[[Y (year)]]}}
→2025 (25UTCpmFri, 18 Jul 2025 19:48:48 +0000){{#time:[[Y "(year)"]]}}
→2025 (year){{#time: i's"}}
→48'48"DieDatum/Zeit-Einheit
kann in jedem von der PHP-Funktionstrtotime() akzeptierten Format sein.Absolute (z. B. 1 $), relative (z. B. 2 $) und kombinierte Zeiten (z. B. 3 $) werden akzeptiert.
{{#time: r|now}}
→Fri, 18 Jul 2025 19:48:48 +0000{{#time: r|+2 hours}}
→Fri, 18 Jul 2025 21:48:48 +0000{{#time: r|now + 2 hours}}
→Fri, 18 Jul 2025 21:48:48 +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}}
→Fehler: Ungültige Zeitangabe{{#time: r|last tuesday}}
→Tue, 15 Jul 2025 00:00:00 +0000DerSprachcode
inISO 639-3 (?) ermöglicht die Anzeige des Strings in der gewählten Sprache
{{#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 2010Der Parameterlocal
gibt an, ob sich dasdate/time object auf die lokale Zeitzone oder auf UTC bezieht.
Dies ist ein boolescher Parameter: Sein Wert wird bestimmt, indem der Wert des Arguments umgewandelt wird (siehe dieoffizielle PHP-Dokumentation für Details darüber, wie Strings in boolesche Werte umgewandelt werden).
$wgLocaltimezone
aufUTC
gesetzt ist, wennlocal
auftrue
oderfalse
gesetzt ist.Vergleiche mit den folgenden Beispielen:
{{#time: Y F d H:i:s|now|it|0}}
→2025 luglio 18 19:48:48{{#time: Y F d H:i:s|now|it|1}}
→2025 luglio 18 19:48:48{{#time: Y F d H:i:s|+2 hours||0}}
→2025 Juli 18 21:48:48{{#time: Y F d H:i:s|+2 hours||1}}
→2025 Juli 18 21:48:48{{#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:00Unix Zeitstempel können in Datumsrechnungen verwendet werden, indem ein@
Symbol vorangestellt wird.
{{#time: U| now}}
→1752868128{{#time: r | @1752868128 }}
→Fri, 18 Jul 2025 19:48:48 +0000![]() | Ohne das Präfix@ vor numerischen Zeitstempelwerten ist das Ergebnis meistens ein Fehler oder ein unerwarteter Wert:
|
![]() | Die gültige Zeitspanne umfasst 1. Januar 0111 → 31. Dezember 9999. Für die Jahre 100 bis 110 ist die Ausgabe inkonsitent und Schaltjahre werden wie die Jahre 100–110: r, D, l und U interpretieren diese Jahre als 2000-2010.
Jahreszahlen 0-99 werden als 2000-2069 und 1970-1999 interpretiert, außer sie werden im 4-Ziffernformat mit führender Null geschrieben:
|
Es können vollständige oder Teile von absoluten Datumsangaben angegeben werden, die Funktion "füllt" die fehlenden Datumsteile mit denaktuellen Werten:
{{#time: Y| January 1}}
→2025![]() | Diese Ausfüllfunktion ist inkonsistent, manche Teile werden mit aktuellen Werten gefüllt, andere nicht:
Es gibt einen Ausnahmefall des eingefüllten Tages:
|
Eine vierstellige Zahl wird immer als Jahr interpretiert, niemals als Stunden und Minuten:[1]
{{#time: Y m d H:i:s| 1959}}
→1959 07 18 00:00:00Eine sechsstellige Zahl wird wenn möglich als Stunden, Minuten und Sekunden interpretiert, aber andernfalls als Fehler (nicht z.B. als Jahr und Monat):
{{#time: Y m d H:i:s| 195909}}
→2025 07 18 19:59:09 Die Eingabe wird als Zeit behandelt statt Jahr- & Monats-Code.{{#time: Y m d H:i:s| 196009}}
→Fehler: Ungültige Zeitangabe Obwohl 19:60:09 keine gültige Zeitangabe ist, wird 196009 nicht als September 1960 interpretiert.Die Funktion führt eine gewisse Menge an Datums-Rechnungen durch:
{{#time: d F Y| January 0 2008}}
→31 Dezember 2007{{#time: d F| January 32}}
→Fehler: Ungültige Zeitangabe{{#time: d F| February 29 2008}}
→29 Februar{{#time: d F| February 29 2007}}
→01 März{{#time:Y-F|now -1 months}}
→2025-JuniDie Gesamtlänge der Formatierungszeichenkette der Funktion#time
ist auf 6000 Zeichen beschränkt.[2]
Es gibt einen Fehler in dieser #time-Parser-Funktion (genauer gesagt in „PHP DateTime“), der die Übergabe von „Nicht-Ganzzahlen“ als relative Zeitzonen-Offsets nicht zulässt. Dieses Problem tritt nicht auf, wenn eine stündliche Zeitzone wie EDT verwendet wird. Zum Beispiel:
{{#time:g:i A| -4 hours}}
→ 3:48 PMIndien hat jedoch einen Zeitversatz von +5,5 Stunden von UTC, und daher ermöglicht die Verwendung seiner Zeitzone normalerweise nicht die korrekte Berechnung eines relativen Zeitzonenversatzes. Folgendes passiert:
{{#time:g:i A| +5.5 hours}}
→ 7:48 PMUm dieses Problem zu umgehen, wandeln Sie einfach die Zeit wie folgt in Minuten oder Sekunden um:
{{#time:g:i A| +330 minutes}}
→ 1:18 AM{{#time:g:i A| +19800 seconds}}
→ 1:18 AM(Tim Starling, der Entwickler dieser Funktion, hat die genaue Syntax für diese Lösung bereitgestellt.)
Manchmal ist es nützlich, einen Zeitstempel herzustellen, der wie der automatische Zeitstempel aussieht, denUnterschriften in Beiträgen auf Diskussionsseiten erzeugen.In einem englischsprachigen Wiki kann sie generiert werden mit:
{{#timel:H:i, j xg Y (e)|+330 minutes}}
→ 01:18, 19 Juli 2025 (UTC)Diese Funktion ist eine Kurzform und somit identisch mit{{#time: ... }}
, wenn der Parameterlocal
auftrue
gesetzt ist, also verwendet sie immer die Ortszeit des Wikis (wie in$wgLocaltimezone eingestellt).
Der Quelltext dieser Funktion sieht folgendermaßen aus:
{{#timel:format string }}
{{#timel:format string |date/time object }}
{{#timel:format string |date/time object |language code }}
$wgLocaltimezone
aufUTC
gesetzt ist, wennlocal
auftrue
oderfalse
gesetzt istSiehe zum Beispiel die folgenden Beispiele:
{{#time:c|now|it}}
→2025-07-18T19:48:48+00:00{{#time:c|now|it|0}}
→2025-07-18T19:48:48+00:00{{#time:c|now|it|1}}
→2025-07-18T19:48:48+00:00{{#timel:c|now|it}}
→2025-07-18T19:48:48+00:00![]() | Beachten Sie, dass U für time und timel die gleiche Anzahl von Sekunden seit dem 01.01.1970 00:00:00 UTC zurückgibt.
|
Diese Funktion formatiert ein Datum gemäß dem Standardformat der ausgewählten Sprache, wie es in$dateFormats
definiert ist (sieheT223772).
{{#timef:Datum/Zeit-Objekt }}
{{#timef:Datum/Zeit-Objekt |Formattyp }}
{{#timef:Datum/Zeit-Objekt |Formattyp |Sprachcode }}
Das Format desDatum/Zeit-Objekts ist dasselbe wie bei#time. Wenn es leer ist, wird die Zeit verwendet, zu der die Seite erstellt worden ist.
DerFormattyp kann sein:
time
date
both
pretty
Wenn derFormattyp nicht festgelegt wird, werden sowohl Zeit als auch Datum angezeigt, als obboth
festgelegt wäre.
Wenn derSprachcode nicht festgelegt wird, wird die Inhaltssprache der Seite verwendet.
Wird#timef
statt#time
verwendet, ermöglicht dies Vorlagen die leichtere Unterstützung mehrfacher Sprachen, da Datumsangaben in verschiedenen Sprachen auf verschiedene Weise formatiert werden.
Im Englischen wird die Reihenfolge von Tag und Monat durch$wgAmericanDates
bestimmt.
Beispiele:
{{#timef:now|both|en}}
→ 19:48, 18 July 2025{{#timef:now|both|ja}}
→ 2025年7月18日 (金) 19:48{{#timef:now|pretty|en}}
→ 18 July{{#timef:now|pretty|pl}}
→ 18 lipca{{#timef:|time}}
→ 19:48Diese Funktion ist die gleiche wie#timef, nur wird die lokale Zeitzone des Wikis verwendet, die in$wgLocaltimezone eingestellt wird.
{{#timefl:date/time object }}
{{#timefl:date/time object |format type }}
{{#timefl:date/time object |format type |language code }}
Diese Funktion trennt einen Seitentitel basierend auf Schrägstrichen in Segmente und gibt dann einige dieser Segmente als Ausgabe zurück.
{{#titleparts:Seitentitel |Anzahl der wiederkehrenden Segmente |Erstes wiederkehrendes Segment }}
Wenn der ParameterAnzahl der zurückzugebenden Segmente nicht angegeben ist, wird standardmäßig „0“ verwendet, wodurch alle Segmente ab demersten zurückzugebenden Segment (einschließlich) zurückgegeben werden. Wenn der Parameterfirst segment to return nicht angegeben ist oder „0“ ist, ist er standardmäßig „1“:
{{#titleparts:Talk:Foo/bar/baz/quok }}
→Talk:Foo/bar/baz/quok{{#titleparts:Talk:Foo/bar/baz/quok | 1 }}
→Talk:Foo Siehe auch {{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 }}
→Negative Werte werden für beide Werte akzeptiert. Negative Werte für den ParameterAnzahl der zurückzugebenden Segmente entfernen effektiv Segmente vom Ende der Zeichenfolge. Negative Werte für daserste zurückzugebende Segment bedeuten „beginne mit diesem Segment, zähle von rechts“:
{{#titleparts:Talk:Foo/bar/baz/quok | -1 }}
→Talk:Foo/bar/baz Entfernt ein Segment vom Ende der Zeichenfolge. Siehe auch {{BASEPAGENAME}}.{{#titleparts: Talk:Foo/bar/baz/quok | -4 }}
→ Entfernt alle 4 Segmente vom Ende der Zeichenfolge{{#titleparts: Talk:Foo/bar/baz/quok | -5 }}
→ Entfernt 5 Segmente vom Ende der Zeichenfolge (mehr als vorhanden){{#titleparts: Talk:Foo/bar/baz/quok | | -1 }}
→ quok Lässt das letzte Segment wiederkehren. Siehe auch {{SUBPAGENAME}}.{{#titleparts: Talk:Foo/bar/baz/quok | -1 | 2 }}
→ bar/baz Entfernt ein Segment vom Ende der Zeichenfolge und gibt dann das zweite Segment und darüber hinaus zurück{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2 }}
→ baz Beginnen Sie mit dem Kopieren beim vorletzten Element; Streifen Sie ein Segment vom Ende der ZeichenfolgeVor der Verarbeitung wird der Parameterpagename HTML-dekodiert: Wenn er einige Standard-HTML-Zeicheneinheiten enthält, werden sie in einfache Zeichen konvertiert (intern kodiert mit UTF-8, d. h. die gleiche Kodierung wie in der MediaWiki-Quellseite mit diese Parser-Funktion).
"
,"
oder"
in „Seitenname“ durch"
ersetzt.{{PAGENAME}}
und ähnliche) sind dafür bekannt, Zeichenfolgen zurückzugeben, die unnötigerweise HTML-kodiert sind, selbst wenn ihr eigener Eingabeparameter nicht HTML-kodiert war:Die Parser-Funktion titleparts kann dann als Problemumgehung verwendet werden, um diese zurückgegebenen Zeichenfolgen so zu konvertieren, dass sie von einigen anderen Parser-Funktionen korrekt verarbeitet werden können, die ebenfalls einen Seitennamen im Parameter verwenden (z. B.{{PAGESINCAT:}}
, die aber immer noch nicht richtig mit HTML-codierten Eingabezeichenfolgen funktionieren.
Wenn die aktuelle Seite beispielsweiseCategory:Côte-d'Or lautet, dann:
{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}
und{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}
geben beide1
zurück; (Die #ifeq-Parserfunktion führt die HTML-Decodierung ihrer Eingabeparameter durch).{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}
und{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}
geben beide1
zurück; (Die Parser-Funktion #switch führt die HTML-Decodierung ihrer Eingabeparameter durch).{{#ifexist: {{FULLPAGENAME}} | 1 | 0 }}
,{{#ifexist: Category:Côte-d'Or | 1 | 0 }}
oder sogar{{#ifexist: Category:Côte-d'Or | 1 | 0 }}
geben alle1
zurück, wenn diese Kategorieseite existiert (die #ifexist-Parser-Funktion führt die HTML-Decodierung ihrer Eingabeparameter durch);{{PAGESINCAT: Côte-d'Or }}
gibt eine Zahl ungleich Null zurück, wenn diese Kategorie Seiten oder Unterkategorien enthält,aber:{{PAGESINCAT: {{CURRENTPAGENAME}} }}
, kann immer nochunbedingt 0 zurückgeben, genau wie:{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}
{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}
Der Grund für dieses unerwartete Verhalten ist, dass es bei den aktuellen Versionen von MediaWiki zwei Vorbehalte gibt:
{{FULLPAGENAME}}
oder sogar{{FULLPAGENAME:Côte-d'Or}}
können den tatsächlich HTML-codierten StringCategory:Côte-d'Or
zurückgeben und nicht den erwartetenCategory:Côte-d'Or
, und das:{{PAGESINCAT: Côte-d'Or }}
bedingungslos gibt 0 zurück (das magische Schlüsselwort PAGESINCAT führt keine HTML-Decodierung seines Eingabeparameters durch).Die einfache Problemumgehung mit Titelteilen (die weiterhin funktionieren, wenn die beiden Vorbehalte in einer späteren Version von MediaWiki behoben werden) ist:
{{PAGESINCAT: {{#titleparts: {{CURRENTPAGENAME}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}
, die alle die tatsächliche Anzahl der Seiten in derselben Kategorie zurückgeben.Dann wird der decodierteSeitenname in einen von MediaWiki unterstützten Standard-Seitentitel kanonisiert, so weit wie möglich:
{{#titleparts: Talk:Foo/bah_boo|1|2}}
→bah boo Nicht bah_boo, sondern ohne den Unterstrich im Original.{{#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{{#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{{#titleparts:talk:a/b/c }}
→Talk:A/b/c{{#titleparts:one/two/three/four|1|1 }}
→One{{#titleparts: one/two/three/four|1|2 }}
→twoWenn Kleinschreibung erforderlich ist, verwenden Sie die Funktion lc:, um die Ausgabe zu steuern:
{{lc: {{#titleparts:one/two/three/four|1|1 }} }}
→oneSie können am Anfang der Zeichenfolge einen 'Dummy'-Schrägstrich voranstellen, um die korrekte Groß- oder Kleinschreibung der ersten Teilzeichenfolge zu erhalten. Verwenden Sie2
anstelle von1
fürerstes zurückzugebendes Segment:
{{#titleparts:/one/two/three/four|1|2 }}
→one{{#titleparts:/One/two/three/four|1|2 }}
→One![]() | Bestimmte Zeichen, die in einem Seitentitelnicht zulässig sind, führen dazu, dass #titleparts die Zeichenfolge nicht auswertet:
|
![]() | Wenn ein Teil des Titels nur „. “ oder „.. “ ist, wird #titleparts die Zeichenfolge nicht analysieren:
|
![]() | Diese Funktion wird nicht ordnungsgemäß herabgesetzt, wenn die Eingabe 255 Byte in UTF-8 überschreitet. Wenn die Eingabezeichenfolge 256 Bytes oder mehr umfasst, wird die gesamte Zeichenfolge zurückgegeben. |
Die Erweiterung ParserFunctions definiert optional verschiedene String-Funktionen wenn$wgPFEnableStringFunctions
auftrue
gesetzt ist.
#len
#pos
#rpos
#sub
#count
#replace
#explode
#urldecode
Weiterführende Informationen finden Sie auf der Unterseite, Beispiele aufManual:Performing string operations with parser functions.
![]() | Im Jahr 2013 wurde entschieden, dassdiese Funktionenniemals in einem Wikimedia-Wiki aktiviert werden, da sie bei großflächiger Nutzung ineffizient sind (siehephab:T8455 für einen Überblick über die Geschichte).Diese Funktionen funktionieren NICHT auf Wikis von Wikimedia! Wenn Sie hier sind, um etwas über ein Wikimedia-Projekt zu schreiben, suchen Sie nach etwas anderem: Wenn Ihr Home-Wiki über String-Funktionen verfügt, verwendet es wahrscheinlichLua. Beispielsweise verwendet die englische WikipediaModule:String, was einige der gleichen Dinge mit völlig unterschiedlicher Syntax bewirkt. Es gibt auch individuelleString-Handling-Vorlagen |
Hier ein kleiner Überblick über dieModule:String Funktionen:
{{#invoke:String|len|target_string}}
{{#invoke:String|sub|target_string|start_index|end_index}}
{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}
{{#invoke:String|pos|target_string|index_value}}
{{#invoke:String|find|source_string|target_string|start_index|plain_flag}}
{{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}
{{#invoke:String|rep|source|count}}
{{#invoke:String|escapePattern|pattern_string}}
{{#invoke:String|count|source_str|pattern_string|plain_flag}}
{{#invoke:String|join|separator|string1|string2|...}}
Parser-Funktionen könnensubstituiert werden, indem dem Hash-Zeichensubst:
vorangestellt wird:
{{subst:#ifexist: Help:Extension:ParserFunctions/de | [[Help:Extension:ParserFunctions/de]] | Help:Extension:ParserFunctions/de }}
→ der Code[[Help:Extension:ParserFunctions/de]]
wird in den Wikitext eingefügt, da die Seite Help:Extension:ParserFunctions/de existiert.![]() | Die Ergebnisse von ersetzten Parser-Funktionen sind undefiniert, wenn die Ausdrückenicht ersetzten flüchtigen Code wievariables oder andere Parser-Funktionen enthalten. Für konsistente Ergebnisse muss der gesamte flüchtige Code im auszuwertenden Ausdruck ersetzt werden. SieheHelp:Substitution. |
Substitution funktioniert nicht innerhalb von<ref>
…</ref>
; Sie können zu diesem Zweck{{subst:#tag:ref|
…}}
verwenden.
Besonders{{#time:
…|now-
…}} könnte inredirects zu Seiten mit Daten praktisch sein, aber das funktioniert nicht.
Parser-Funktionen werden diewikitable-Syntax und Pipe-Zeichen (|
) verstümmeln und alle rohen Pipe-Zeichen als Parameterteiler behandeln.Um dies zu vermeiden, verwendeten die meisten Wikis ein TemplateTemplate:!, dessen Inhalt nur ein Pipe-Rohzeichen (|
) war, seit MW 1.24 ersetzte ein{{!}}
word diesen Humbug.Dies „versteckt“ die Pipe vor dem MediaWiki-Parser und stellt sicher, dass sie nicht berücksichtigt wird, bis alle Vorlagen und Variablen auf einer Seite erweitert wurden.Es wird dann als Tabellenzeilen- oder Spaltentrenner interpretiert.Alternativ kann eine rohe HTML-Tabellensyntax verwendet werden, obwohl dies weniger intuitiv und fehleranfälliger ist.
Sie können bei der Anzeige das Pipe-Zeichen | als einfaches, unverarbeitetes Zeichen umgehen, indem sie ein HTML-Sonderzeichen verwenden:|
oder|
.
Beschreibung | Man tippt | Man erhält |
---|---|---|
Umgehung des Pipe-Zeichens als Trennzeichen für Tabellenzeilen/Spalten | {{!}} | | |
Umgehung des Pipe-Zeichen als einfaches Zeichen | | | | |
Derselbe Pipe-Schutz gilt in folgendem Beispiel:
{{Documentation|content=... text before ...<code>subpage-name=sandbox3</code> is equivalent to <code>sandbox link=../sandbox3 | sandbox name=sandbox3</code>.... text after ...}}
Wir stellen fest, dasstext after nicht angezeigt wird, wenn vorsandbox name= die Pipe | steht, da|sandbox name= fälschlicherweise als Parameter der VorlageDocumentation betrachtet wird, der auf einer Stufe mit|content= steht.
Leerzeichen, einschließlich Zeilenumbrüche, Tabulatoren und Leerzeichen, werden am Anfang und am Ende aller Parameter dieser Parser-Funktionen entfernt. Wenn dies nicht erwünscht ist, können Zeichenfolgen verglichen werden, nachdem sie in Anführungszeichen gesetzt wurden.
{{#ifeq: foo | foo | equal | not equal }}
→equal{{#ifeq: "foo " | " foo" | equal | not equal }}
→not equalUm das Trimmen von then und anderen Teilen zu verhindern, siehem:Template:If. Einige Leute erreichen dies, indem sie <nowiki> </nowiki> statt Leerzeichen verwenden.
foo{{#if:|| bar}}foo
→foobarfoofoo{{#if:||<nowiki/>bar<nowiki/>}}foo
→foo bar fooDiese Methode kann jedoch nur verwendet werden, um eineinzelnes Whitespace-Zeichen zu rendern, da der Parser mehrere Whitespace-Zeichen hintereinander zu einem komprimiert.
<spanstyle="white-space: pre;">foo{{#if:||<nowiki/> bar<nowiki/>}}foo</span> | → | foo bar foo |
In diesem Beispiel wird der Stilwhite-space: pre
verwendet, um zu erzwingen, dass die Leerzeichen vom Browser beibehalten werden, aber selbst damit werden die Leerzeichen nicht angezeigt. Dies geschieht, weil die Leerzeichen von der Software entfernt werden, bevor sie an den Browser gesendet werden.
Es ist möglich, dieses Verhalten zu umgehen, indem Leerzeichen durch 
(breakable space) oder
(non-breakable space) ersetzt werden, da sie von der Software nicht modifiziert werden:
<spanstyle="white-space: pre;">foo{{#if:||   bar   }}foo</span>
→foo bar foofoo{{#if:|| bar }}foo
→foo bar fooZu beachten ist, dass nicht alle Parameter identisch erzeugt werden.In ParserFunctions werden Leerzeichen am Anfang und Ende immer entfernt.Intemplates werden Leerzeichen am Anfang und Ende von benannten und benannten unbenannten Parametern entfernt, nicht jedoch von unbenannten Parametern:
"{{lc: AbC}}"
→ "abc"[1]"{{uc: AbC}}"
→ "ABC"[2]"{{lcfirst: AbC}}"
→ "abC"[3]"{{ucfirst: abc}}"
→ "Abc"[4]"{{urlencode: AbCdEf ghi}}"
wird ausgegeben als
"AbC%0AdEf+ghi"
Das heißt, dass ein neuer Zeilenbeginn innerhalb der Zeichenkette in %0A und dazwischenliegende Leerzeichen in + umgewandelt werden.
{{anchorencode: AbC dEf ghi}}
wird ausgegeben als
AbC_dEf_ghi