fn (Zahl formatieren)

Formatiert eine Zahl im Schema der aktuellen Sprache.
Tooltip
Syntax: $fn(number,[precision=2[,integerDigits=1,[useThousandsSeparator=false]]])
Parameter
Beschreibung
number
Die zu formatierende Zahl
precision
Die Anzahl der Nachkommastellen
integerDigits
Die minimale Anzahl an Ganzzahlstellen
useThousandsSeparator
Tausendertrennzeichen verwenden
keepUnits
Sollte es sich um eine Zahl mit Einheit handeln, wird die Einheit in den Ergebnistext mit aufgenommen
Gibt die formatierte Zahl als Text zurück.

Syntax

$fn(number,[precision=2[,integerDigits=1,[useThousandsSeparator=false]]])

Parameter

Name	Beschreibung
number	Die zu formatierende Zahl
precision	Die Anzahl der Nachkommastellen. Wie vor abgeschnittenen Stellen gerundet wird, wird über den Sprachverwaltungseintrag: lobsterui/rounding festgelegt. Unterstützte Werte sind: NONE - Kein Runden, nur abschneiden DOWN - Immer abrunden UP - Immer aufrunden NEAREST - Zur näher liegenden Stelle runden (z.B. 0.51 → 0.5, 0.55 → 0.6)
integerDigits	Die minimale Anzahl an Ganzzahlstellen. Hinweis: Es werden keine Stellen abgeschnitten. Fehlende Stellen werden hingegen mit 0 aufgefüllt. Daher kann hier auch als Wert $null (leer), 0 oder 1 verwendet werden, um das Auffüllen zu deaktivieren.
useThousandsSeparator	Tausendertrennzeichen verwenden
keepUnits	Sollte es sich um eine Zahl mit Einheit handeln, wird die Einheit in den Ergebnistext mit aufgenommen

Hinweis: Als Dezimal- und Tausendertrenner werden die Sprachverwaltungseinträge lobsterui/decimalSeparator und lobsterui/thousandsSeparator herangezogen.

Rückgabewert

Die formatierte Zahl als Text.

Beispiele

Syntax	Ergebnis
$fn(2.5,3)	2,500
$fn(2.5,3,2)	02,500
$fn(1500,2)	1500,00
$fn(1500,2,0)	1500,00
$fn(1500,2,0,$true)	1.500,00