Vorlage:FormatZahl/Doku: Unterschied zwischen den Versionen

Aus ÖsterreichWiki
Zur Navigation springen Zur Suche springen
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]]

Version vom 31. Juli 2016, 17:08 Uhr

Dokumentations-Unterseite 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 auf Vorlage Diskussion:FormatZahl abzustimmen.

Diese Vorlage entspricht grob der MediaWiki-Standardfunktion {{ZAHLENFORMAT}}, 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 <!-- 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

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.

Beispiele

Achtung, die Einrückung rechts macht nicht diese Vorlage, die muss man manuell ja nach Ergebnis ergänzen. In Tabellen wie dieser ist die Vorlage daher unnütz.
Vorlage-Syntax Dargestelltes Ergebnis negativer Wert
{{FormatZahl|1987654321.1234}} 1.987.654.321,00 -1.987.654.321,00
{{FormatZahl|987654321.1234}} 987.654.321,00 -987.654.321,00
{{FormatZahl|87654321.1234}} 87.654.321,00 -87.654.321,00
{{FormatZahl|7654321.1234}} 7.654.321,00 -7.654.321,00
{{FormatZahl|654321.1234}} 654.321,00 -654.321,00
{{FormatZahl|54321.1234}} 54.321,00 -54.321,00
{{FormatZahl|4321.1234}} 4321,00 -4321,00
{{FormatZahl|321.1234}} 321,10 -321,10
{{FormatZahl|21.1234}} 21,10 -21,10
{{FormatZahl|1.1234}} 1,12 -1,12
{{FormatZahl|.1234}} 0,12 -0,12
{{FormatZahl|.01234}} 0,01 -0,01
{{FormatZahl|.001234}} 0,00 0,00
{{FormatZahl|54321.123|T}} 54.321,00 -54.321,00
{{FormatZahl|4321.123|T}} 4.321,00 -4.321,00
{{FormatZahl|321.123|T}} 321,10 -321,10
{{FormatZahl|1987654321|LAND=CH}} 1'987'654'321,00 -1'987'654'321,00
{{FormatZahl|987654321|LAND=CH}} 987'654'321,00 -987'654'321,00
{{FormatZahl|87654321|LAND=CH}} 87'654'321,00 -87'654'321,00
{{FormatZahl|7654321|LAND=CH}} 7'654'321,00 -7'654'321,00
{{FormatZahl|54321.123|LAND=CH}} 54'321,00 -54'321,00
{{FormatZahl|4321.123|LAND=CH}} 4321,00 -4321,00
{{FormatZahl|321.123|LAND=CH}} 321,00 -321,00
{{FormatZahl|21.123|LAND=CH}} 21.10 -21.10
{{FormatZahl|1.123|LAND=CH}} 1.12 -1.12
{{FormatZahl|54321.123|T|LAND=CH}} 54'321,00 -54'321,00
{{FormatZahl|4321.123|T|LAND=CH}} 4'321,00 -4'321,00
{{FormatZahl|321.123|T|LAND=CH}} 321,00 -321,00
{{FormatZahl|ungültig}} ungültig

Siehe auch

Abgerufen von „https://oesterreichwiki.org/w/index.php?title=Vorlage:FormatZahl/Doku&oldid=118753“