Funktion 'Zahlen formatieren' (Format Number)

Die Funktion Zahlen formatieren gibt eine Zeichenfolge zurück, die eine dem angegebenen Muster entsprechend formatierte Zahl darstellt.

Parameter: number (Zahl)

Die zu formatierende Zahl. Dieser Wert kann von einem Quellenknoten bereitgestellt werden, das Ergebnis einer anderen Funktion sein oder von Ihnen angegeben werden.

Parameter: string (Zeichenfolge)

Ein Muster, das angibt, wie der erste Parameterwert zu formatieren ist. Dieses Muster verwendet die folgenden Symbole zur Definition des Musters:
  • Erforderliche Stellen = 0
  • Optionale Stellen = #
  • Minussymbol = -
  • Dezimalzeichen = .
  • Blocktrennzeichen = ,. Dient in der Regel zur Trennung von Gruppen (Blöcken) aus jeweils drei Stellen.
  • Prozentsymbol = %. Wenn das Prozentsymbol vorhanden ist, wird die Eingabezahl mit 100 multipliziert und das Ergebnis als Prozentwert angezeigt.
  • Promillesymbol = (Unicode x2030). Durch dieses Symbol wird die Zahl mit 1000 multipliziert und das Ergebnis als Promillwert angezeigt.
  • Positiv/Negativ-Trennzeichen = ;
  • Unendlichsymbol = infinity
  • Nichtzahl = NaN (Not a Number)
  • $ = $
Muster können konstanten Text als Präfix, Suffix oder beides enthalten. Häufige Verwendungen sind zum Beispiel die Angabe des Währungssymbols oder einer Maßeinheit.
  • $#,##0.00 – Formatiert eine Zahl im Standardformat für US-Dollar mit dem Dollarzeichen, Kommas als Tausendertrennzeichen und mindestens eine Dollarstelle und zwei Centstellen.
  • #0.000% – Formatiert eine Dezimalzahl als Prozentwert mit mindestens drei Dezimalstellen.
  • #,##0.00;(#,##0.00) – Formatiert eine negative Zahl mit Klammern in einem in der Buchführung gängigen Format.

Rückgabe: Zeichenfolge

Der erste Parameter in einem Format, das dem im zweiten Parameter angegebenen Muster entspricht.

Beispiele

Muster können konstanten Text als Präfix, Suffix oder beides enthalten. Häufige Verwendungen sind zum Beispiel die Angabe des Währungssymbols oder einer Maßeinheit.  

Beispiel 1

$#,##0.00 – Formatiert eine Zahl im Standardformat für US-Dollar mit dem Dollarzeichen, Kommas als Tausendertrennzeichen und mindestens eine Dollarstelle und zwei Centstellen.

format-number(12345.6789,'$#,##0.00') = '$12,345.67'
Beispiel 2

#0.000% – Formatiert eine Dezimalzahl als Prozentwert mit mindestens drei Dezimalstellen.

format-number(.67890123,'#0.000%') = '67.890%'

Wenn das Prozentsymbol vorhanden ist, wird die Eingabezahl mit 100 multipliziert.

Beispiel 3

#,##0.00;(#,##0.00) – Formatiert eine negative Zahl mit Klammern in einem in der Buchführung gängigen Format.

format-number(-12345.6789,'#,##0.00;(#,##0.00)') = '(12,345.67)'