Vorlage:ZahlFormat
Dokumentation ansehen • bearbeiten • Versionsverlauf • Cache leeren
(z. B. Dezimaltrennzeichen, Tausendertrennzeichen). Sie ist kein Rechenwerkzeug, sondern ein Anzeigehelfer.
Grundprinzip Bearbeiten
- Die Vorlage formatiert Zahlen ausschließlich für die Darstellung.
- Die Formatierung richtet sich standardmäßig nach der Seitensprache (Content Language).
- Die Benutzersprache (Interface-Sprache) wird bewusst nicht berücksichtigt, um eine konsistente Darstellung und einen stabilen Parser-Cache zu gewährleisten.
Kanonischer Eingabewert Bearbeiten
Als Eingabe wird ein kanonischer Zahlenwert erwartet:
- Dezimaltrennzeichen: Punkt (
.) - keine Tausendertrennzeichen
Beispiele:
1000.45(korrekt)1.000,45(nicht als Eingabe gedacht)1,000.45(nicht als Eingabe gedacht)
Die Vorlage versucht nicht, frei eingegebene Zahlformate zu erkennen oder zu interpretieren.
Verwendung Bearbeiten
Ein einfaches Beispiel:
{{ZahlFormat|1000.45}}
Die Zahl wird entsprechend der Seitensprache formatiert.
Optional kann die Sprache explizit angegeben werden (Sonderfälle):
{{ZahlFormat|1000.45|lang=en}}
Vorlagenparameter
| Parameter | Beschreibung | Typ | Status | |
|---|---|---|---|---|
| Zahl | zahl1 | Die zu formatierende Zahl (erforderlich)
| Zahlenwert | erforderlich |
| Sprache | lang | Für die Formatierung eingesetzte Sprache
| Einzeiliger Text | optional |
| Dezimalsstellen | decimals | Anzahl der Nachkommastellen
| Zahlenwert | optional |
| Tausendertrennzeichen | thousandsSep | Benutzerdefiniertes Tausenderzeichen (überschreibt den Sprachstandard) | Einzeiliger Text | optional |
| Dezimaltrennzeichen | decimalMark | Benutzerdefiniertes Dezimalzeichen (überschreibt den Sprachstandard) | Einzeiliger Text | optional |
Rundung Bearbeiten
Die Vorlage rundet Zahlen kaufmännisch auf die angegebene Anzahl von Dezimalstellen. Es erfolgt kein Abschneiden.
Beispiel:
{{ZahlFormat|1.555|decimals=2}}
→ 1,56
Die Vorlage ist nicht für komplexe numerische Berechnungen gedacht.
Wer exakte mathematische Kontrolle benötigt, sollte dies vor der Übergabe an die Vorlage erledigen
(z. B. mit Parserfunktionen wie #expr).
Typische Stolperstellen Bearbeiten
- Die Vorlage ersetzt keine Rechenlogik.
- Sie ändert keine Inhalte „automatisch“, sondern nur die Darstellung der übergebenen Zahl.
- Zahlen im Fließtext, die nicht über diese Vorlage ausgegeben werden, unterliegen keiner Vereinheitlichung.
Empfohlene Nutzung Bearbeiten
- Für konsistente Darstellung von Zahlen im Fließtext
- Für strukturierte Daten (z. B. Infoboxen), insbesondere bei Werten aus dem Datenwiki
- Nicht gedacht als Ersatz für mathematische Berechnungen
Beispiele für andere Sprachen Bearbeiten
{{ZahlFormat|1234567.89|lang=de}}→1.234.567,89{{ZahlFormat|1234567.89|lang=en}}→1,234,567.89{{ZahlFormat|1234567.89|lang=ch}}→1’234’567.89
Hinweise Bearbeiten
Diese Vorlage ist ein Wrapper für Modul:NumberFormat. Sie ermöglicht die Benutzung im VisualEditor und für nicht-technische Nutzer.Vorlagenpflege & Verwendung