Vorlage:ZahlFormat/Doku

Diese Vorlage dient der formatierten Darstellung von Zahlen im Wiki (z. B. Dezimaltrennzeichen, Tausendertrennzeichen). Sie ist kein Rechenwerkzeug, sondern ein Anzeigehelfer.

Grundprinzip

• 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

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

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}}

TemplateData

Formatiert Zahlen abhängig von Sprache und Wunschpräzision.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Zahl	zahl 1	Die zu formatierende Zahl (erforderlich) Beispiel 1234.45	Zahlenwert	erforderlich
Sprache	lang	Für die Formatierung eingesetzte Sprache Vorgeschlagene Werte de at ch en Standard Abhängig von Seitensprache	Einzeiliger Text	optional
Dezimalsstellen	decimals	Anzahl der Nachkommastellen Beispiel 2	Zahlenwert	optional
Tausendertrennzeichen	thousandsSep	Benutzerdefiniertes Tausenderzeichen (überschreibt den Sprachstandard)	Einzeiliger Text	optional
Dezimaltrennzeichen	decimalMark	Benutzerdefiniertes Dezimalzeichen (überschreibt den Sprachstandard)	Einzeiliger Text	optional

Format: inline

Rundung

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

• 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

• 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

• {{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

Diese Vorlage ist ein Wrapper für Modul:NumberFormat. Sie ermöglicht die Benutzung im VisualEditor und für nicht-technische Nutzer.