Vorlage:FormatZahl/Doku: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen
keine Bearbeitungszusammenfassung
K (22 Versionen)
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
{{VonWP}}
<noinclude>{{Dokumentation/Dokuseite}}
</noinclude>{{Achtung|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 [[Hilfe:Variablen#Funktionen|<nowiki>{{ZAHLENFORMAT}}</nowiki>]] verwenden, für das Schweizer Zahlenformat ist mangels Alternativen, sofern anwendbar, diese Vorlage einzusetzen.}}
{{Tausendfach verwendet}}
 
Diese Vorlage entspricht grob der MediaWiki-Standardfunktion [[Hilfe:Variablen#Funktionen|<nowiki>{{ZAHLENFORMAT}}</nowiki>]], hat jedoch erweiterte Funktionen:
* das Tausendertrennzeichen wird standardmäßig entsprechend [[Wikipedia:Schreibweise von Zahlen]] 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 <code><nowiki><!-- schweizbezogen --></nowiki></code>);
* 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. <code>2 / 3</code>) 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 <code>999.999.999.999</code> und <code>-999.999.999.999</code>
 
== Aufruf ==
 
<code><nowiki>{{FormatZahl|zahl|t|LAND=land}}</nowiki></code>
 
Der unbenannte Parameter <code>Zahl</code> muss angegeben werden, alle weiteren benannten Parameter sind optional.
 
{| class="wikitable toptextcells"
! Parameter !! Default-Wert !! Erläuterung
|-
| <code>zahl</code>
| - keiner –
| Die zu formatierende Zahl als unbenannter Parameter in Computer-Schreibweise, d. h. ohne Tausendertrennzeichen und mit Punkt als Dezimaltrennzeichen.
Beispiel: <code>1234.567</code>
|-
| <code>t</code>
| - keiner –
| Das Tausendertrennzeichen wird auch bei vierstelligen Zahlen ausgegeben. Das „T“ muss als zweiter Parameter angegeben werden.
|-
| <code>LAND</code>
| <code>DE</code>
| Länderkürzel entsprechend [[ISO 3166|ISO 3166-1]]. Derzeit werden alle Angaben außer <code>CH</code> (für die Schweiz) und <code>LI</code> (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.
|}
 
== Beispiele ==
: '''Achtung, die Einrückung rechts macht <u>nicht</u> diese Vorlage, die muss man manuell ja nach Ergebnis ergänzen. In Tabellen wie dieser ist die Vorlage daher unnütz.'''
{| class="wikitable" style="text-align:right;"
|- class="hintergrundfarbe6"
!Vorlage-Syntax!!Dargestelltes Ergebnis !! negativer Wert
|-
|<nowiki>{{FormatZahl|1987654321.1234}}</nowiki> ||{{FormatZahl|1987654321.1234}}{{0|,00}} ||{{FormatZahl|-1987654321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|987654321.1234}}</nowiki> ||{{FormatZahl|987654321.1234}}{{0|,00}} ||{{FormatZahl|-987654321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|87654321.1234}}</nowiki> ||{{FormatZahl|87654321.1234}}{{0|,00}} ||{{FormatZahl|-87654321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|7654321.1234}}</nowiki> ||{{FormatZahl|7654321.1234}}{{0|,00}} ||{{FormatZahl|-7654321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|654321.1234}}</nowiki> ||{{FormatZahl|654321.1234}}{{0|,00}} ||{{FormatZahl|-654321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|54321.1234}}</nowiki> ||{{FormatZahl|54321.1234}}{{0|,00}} ||{{FormatZahl|-54321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|4321.1234}}</nowiki> ||{{FormatZahl|4321.1234}}{{0|,00}} ||{{FormatZahl|-4321.1234}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|321.1234}}</nowiki> ||{{FormatZahl|321.1234}}{{0}} ||{{FormatZahl|-321.1234}}{{0}}
|-
|<nowiki>{{FormatZahl|21.1234}}</nowiki> ||{{FormatZahl|21.1234}}{{0}} ||{{FormatZahl|-21.1234}}{{0}}
|-
|<nowiki>{{FormatZahl|1.1234}}</nowiki> ||{{FormatZahl|1.1234}} ||{{FormatZahl|-1.1234}}
|-
|<nowiki>{{FormatZahl|.1234}}</nowiki> ||{{FormatZahl|.1234}} ||{{FormatZahl|-.1234}}
|-
|<nowiki>{{FormatZahl|.01234}}</nowiki> ||{{FormatZahl|.01234}} ||{{FormatZahl|-.01234}}
|-
|<nowiki>{{FormatZahl|.001234}}</nowiki> ||{{FormatZahl|.001234}}{{0|,00}} ||{{FormatZahl|-.001234}}{{0|,00}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|54321.123|T}}</nowiki> ||{{FormatZahl|54321.123|T}}{{0|,00}} ||{{FormatZahl|-54321.123|T}}{{0|,00}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|4321.123|T}}</nowiki> ||{{FormatZahl|4321.123|T}}{{0|,00}} ||{{FormatZahl|-4321.123|T}}{{0|,00}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|321.123|T}}</nowiki> ||{{FormatZahl|321.123|T}}{{0}} ||{{FormatZahl|-321.123|T}}{{0}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|1987654321|LAND=CH}}</nowiki> ||{{FormatZahl|1987654321|LAND=CH}}{{0|,00}} ||{{FormatZahl|-1987654321|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|987654321|LAND=CH}}</nowiki> ||{{FormatZahl|987654321|LAND=CH}}{{0|,00}} ||{{FormatZahl|-987654321|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|87654321|LAND=CH}}</nowiki> ||{{FormatZahl|87654321|LAND=CH}}{{0|,00}} ||{{FormatZahl|-87654321|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|7654321|LAND=CH}}</nowiki> ||{{FormatZahl|7654321|LAND=CH}}{{0|,00}} ||{{FormatZahl|-7654321|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|54321.123|LAND=CH}}</nowiki> ||{{FormatZahl|54321.123|LAND=CH}}{{0|,00}} ||{{FormatZahl|-54321.123|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|4321.123|LAND=CH}}</nowiki> ||{{FormatZahl|4321.123|LAND=CH}}{{0|,00}} ||{{FormatZahl|-4321.123|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|321.123|LAND=CH}}</nowiki> ||{{FormatZahl|321.123|LAND=CH}}{{0|,00}} ||{{FormatZahl|-321.123|LAND=CH}}{{0|,00}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|21.123|LAND=CH}}</nowiki> ||{{FormatZahl|21.123|LAND=CH}}{{0}} ||{{FormatZahl|-21.123|LAND=CH}}{{0}}
|- style="background:#FFCCFF;"
|<nowiki>{{FormatZahl|1.123|LAND=CH}}</nowiki> ||{{FormatZahl|1.123|LAND=CH}} ||{{FormatZahl|-1.123|LAND=CH}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|54321.123|T|LAND=CH}}</nowiki> ||{{FormatZahl|54321.123|T|LAND=CH}}{{0|,00}} ||{{FormatZahl|-54321.123|T|LAND=CH}}{{0|,00}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|4321.123|T|LAND=CH}}</nowiki> ||{{FormatZahl|4321.123|T|LAND=CH}}{{0|,00}} ||{{FormatZahl|-4321.123|T|LAND=CH}}{{0|,00}}
|- style="background:#FFFFCC;"
|<nowiki>{{FormatZahl|321.123|T|LAND=CH}}</nowiki> ||{{FormatZahl|321.123|T|LAND=CH}}{{0|,00}} ||{{FormatZahl|-321.123|T|LAND=CH}}{{0|,00}}
|-
|<nowiki>{{FormatZahl|ungültig}}</nowiki> ||{{FormatZahl|ungültig}} ||<br />
|}
 
== Siehe auch ==
 
* [[Vorlage:FormatZahlLokal]]
* [[Vorlage:FormatDate]]
4.763

Bearbeitungen

Navigationsmenü