fn (Zahl formatieren)

Formatiert eine Zahl im Schema der aktuellen Sprache.

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