NumberFormat funktion

Syntax

NumberFormat(number, pattern, [options])

Parameter

• zahl: Der numerische Wert, der formatiert werden soll. Hinweis: Dieser Parameter akzeptiert einen Ausdruck, d. h. Sie können einen Literalwert, einen Spaltenverweis oder das Ergebnis einer anderen Funktion angeben. Erforderlich
• muster: Eine Zeichenkette, die das Format für positive Zahlen und optional für negative Zahlen, getrennt durch ein Semikolon, angibt (z. B. "#,###.#;(#,###.#)"). Optional
• optionen: Optionale benannte Argumente, die zusätzliches Formatierungsverhalten steuern. Folgende Optionen werden unterstützt:
  • compact: Kurzschriftformatierung anwenden (siehe Abschnitt "Compact Notation Reference" unten für unterstützte Werte)
  • negSymbol: Verwenden Sie dash, parens, none oder default für die Anzeige von negativen Zahlen
  • posColor negColor: Festlegen der Schriftfarben anhand von HTML-Hex-Codes (z. B. ) #FF0000
  • posBold, negBold: Fettdruck anwenden (true, false)
  • posItalic, negItalic: Kursive Formatierung anwenden (true, false)
  • posUnderline, negUnderline: Unterstreichung anwenden (true, false)
  • posPrefix negPrefix: HTML/Text vor der Nummer hinzufügen
  • posSuffix negSuffix: HTML/Text nach der Nummer hinzufügen Optional

Verhalten

• Konvertiert eine numerische Eingabe in eine Zeichenkette, die entsprechend dem/den angegebenen Muster(n) formatiert ist.
• Unterstützt Rundungen, Währungssymbole, Prozentsätze, exponentielle Notation und Byte/Bit-Kurzzeichen.
• Kann Dauern (in Sekunden) in formatierte Zeichenketten wie "2 Stunden, 2 Minuten" umwandeln.
• Bietet eine binäre Formatierung für Datengrößen unter Verwendung von Codes wie XA, XK usw.
• Wendet die halbe Aufrundung an: Werte, die auf 1-4 enden, runden ab, 5-9 runden auf.
• Wenn kein Muster angegeben wird, werden die Zahlen auf ganze Zahlen gerundet und mit Kommas angezeigt.

Beispiele

NumberFormat({Revenue}, "$#,##0.00"): Formatiert die Spalte {Revenue} als Währung mit zwei Nachkommastellen, z. B. "$1, 234.56 ".

NumberFormat(7322, "s"): Konvertiert 7322 Sekunden in eine formatierte Dauerzeichenfolge: "2 Stunden, 2 Minuten und 2 Sekunden".

NumberFormat(922, "MB"): Formatiert 922 MB in eine menschenlesbare Zeichenfolge wie " 0.9 GB".

NumberFormat(Percent, "00%"): Formatiert einen Prozentsatz mit zwei Ziffern, z.B. 0.42 wird zu "42%".

NumberFormat($_, "#,###.#B", compact="XA"): Formatiert einen Datenwert in binärer Kurzschrift, z. B. " 1.0 GB".

NumberFormat(-62619000.185, "#,###.#B;(#,###.##)"): Formatiert die negative Zahl -62,619, 000.185 unter Verwendung des positiven Musters #,###.#B und des negativen Musters (#,###.##), was zu (62,619,000.19) führt.

NumberFormat({NetIncome}, "$#,##0.00", compact="M", negColor="#FF0000", posBold=true): Formatiert die Spalte {NetIncome} als Währung in Millionen. Negative Zahlen erscheinen in Rot, positive Zahlen sind fett gedruckt.

Hinweise

• Verwenden Sie diese Funktion nur in Spalten vom Typ Etikett oder in der Formatformel von metrischen/reportierenden neuen Spalten.
• Die Formatierung wird in numerischen Spalten ignoriert.
• Wenn weder Muster noch negativePattern angegeben wird, werden die Werte auf die nächste Ganzzahl mit Tausendertrennzeichen gerundet.
• Achten Sie bei der Formatierung von HTML darauf, dass die Präfix/Suffix-Tags ausgewogen und gültig sind.

Kompakte Notation Referenz

Die folgenden Tabellen zeigen die unterstützten Werte der kompakten Notation. In den Tabellen zeigt die Spalte Code die Werte, die Sie nach dem optionalen Parameter compact= eingeben können. Die Spalte Muster für Diagramme zeigt die Zusätze, die Sie am Ende des Formatmusters einfügen können.

Standard-Kurzschrift-Notationen

Die folgenden Standardkurzschreibweisen werden unterstützt. Die für jedes Standardkurzschriftformat angezeigten Symbole sind landesspezifisch und können im Projekteinstellungsdialog neu konfiguriert werden. So würde zum Beispiel diese Zahlenformatfunktion alle Standardkurzschreibweisen verwenden:

=NumberFormat($_, „#.#“, kompakt=A)

Binäre Kurzschreibweise

Die folgenden binären Kurzschreibweisen werden ebenfalls unterstützt:

Wenn Sie binäre Abkürzungen verwenden, fassen Sie meist eine Anzahl von Bytes zusammen. In diesem Fall verwenden Sie dies als Ihre NumberFormat Erklärung:

=NumberFormat($_, „#,###.#B“, compact=„XA“)

Um dies in einem Diagramm anzuzeigen, geben Sie als Diagrammnummer folgendes Format ein: #, ###.#B{@Xa }

Rückgabetyp

Zeichenfolge