Vorlage:FormatZahl/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:FormatZahl.

Diese Vorlage soll nur in anderen Vorlagen und nicht direkt in Artikeln oder Tabellen verwendet werden. In Artikeln oder Tabellen bitte für das deutsche Zahlenformat die MediaWiki-Standardfunktion {{ZAHLENFORMAT}} verwenden, für das Schweizer Zahlenformat ist mangels Alternativen, sofern anwendbar, diese Vorlage einzusetzen.

Diese Vorlage ist vielfach eingebunden. Wenn du die Auswirkungen genau kennst, kannst du sie bearbeiten. Meist ist es jedoch sinnvoll, Änderungswünsche erst mit den jeweiligen Bearbeitern dieser Vorlage abzustimmen.

Diese Vorlage entspricht grob der MediaWiki-Standardfunktion {{ZAHLENFORMAT}}, hat jedoch erweiterte Funktionen:

• das Tausendertrennzeichen wird standardmäßig erst ab der fünften Stelle angewandt, optional kann es durch Angabe eines „T“ als zweiter Parameter auch bei vierstelligen Zahlen gesetzt werden;
• ein optionaler Parameter für das Land erlaubt die Unterscheidung zwischen der Zahlenformatierung für Deutschland, Österreich, Schweiz und Liechtenstein (entsprechend der Angabe <!-- schweizbezogen -->);
• der Wert wird auf maximal zwei Nachkommastellen gerundet, so dass bei Werten mit Nachkommastellen maximal drei signifikante Stellen ausgegeben werden;
• der angegeben Parameter kann auch ein Ausdruck (z. B. 2 / 3) sein.

Die Vorlage ist weniger zur Verwendung in Artikeltexten als mehr zur Ausgabe variabler oder berechneter Werte in Infoboxen vorgesehen. Sie ist geeignet für Zahlen zwischen 999.999.999.999 und -999.999.999.999

1 Aufruf

{{FormatZahl|zahl|t|LAND=land}}

Der unbenannte Parameter Zahl muss angegeben werden, alle weiteren benannten Parameter sind optional.

Parameter	Default-Wert	Erläuterung
zahl	- keiner –	Die zu formatierende Zahl als unbenannter Parameter in Computer-Schreibweise, d. h. ohne Tausendertrennzeichen und mit Punkt als Dezimaltrennzeichen. Beispiel: 1234.567
t	- keiner –	Das Tausendertrennzeichen wird auch bei vierstelligen Zahlen ausgegeben. Das „T“ muss als zweiter Parameter angegeben werden.
land	DE	Länderkürzel entsprechend ISO 3166-1. Derzeit werden alle Angaben außer CH (für die Schweiz) und LI (für Liechtenstein) als Zahlenformatierung für Deutschland und Österreich interpretiert. Soll jedoch die aktuell eingestellte Oberflächensprache der MediaWiki-Software verwendet werden, ist Vorlage:FormatZahlLokal zu verwenden.

2 Beispiele

Vorlage-Syntax	Dargestelltes Ergebnis
{{FormatZahl|3012}}	3012
{{FormatZahl|3012|T}}	3.012
{{FormatZahl|23001}}	23.001
{{FormatZahl|-1234567890}}	-1.234.567.890
{{FormatZahl|1234567890|LAND=ch}}	1'234'567'890
{{FormatZahl|12345|LAND=LI}}	12'345
{{FormatZahl|1234|T|LAND=LI}}	1'234
{{FormatZahl|123.4}}	123,4
{{FormatZahl|12.34}}	12,3
{{FormatZahl|1.234}}	1,23
{{FormatZahl|0.123}}	0,12
{{FormatZahl|-123.4|T|LAND=CH}}	-123
{{FormatZahl|-12.34|T|LAND=CH}}	-12.3
{{FormatZahl|-1.234|T|LAND=CH}}	-1.23
{{FormatZahl|-0.123|T|LAND=CH}}	-0.12
{{FormatZahl|ungültig}}	ungültig

3 Siehe auch

• Vorlage:FormatZahlLokal
• Vorlage:FormatDate