Benutzerdefinierte Zahlenformatzeichenfolgen

Sie können eine aus einem oder mehreren benutzerdefinierten Zahlenbezeichnern bestehende benutzerdefinierte numerische Formatzeichenfolge erstellen, um anzugeben, wie numerische Daten formatiert werden sollen. Eine benutzerdefinierte numerische Formatzeichenfolge ist eine beliebige Formatzeichenfolge, die keine standardmäßige numerische Formatzeichenfolge ist.

Die folgenden Tabelle beschreibt die benutzerdefinierten Zahlenformatbezeichner und zeigt eine Beispielausgabe an, die von den einzelnen Formatbezeichnern erstellt wird. Wechseln Sie zum Abschnitt "Notizen ", um weitere Informationen zur Verwendung benutzerdefinierter zahlenformatischer Zeichenfolgen und des Beispielabschnitts für eine umfassende Darstellung ihrer Verwendung zu finden.

Formatbezeichner	name	Beschreibung	Beispiele
0	0-Platzhalter	Ersetzt die Ziffer 0 ggf. durch eine entsprechende vorhandene Ziffer; andernfalls wird die Ziffer 0 in der Ergebniszeichenfolge angezeigt. Weitere Informationen finden Sie unter: Der benutzerdefinierte Spezifizierer „0“	1234.5678 („00000“) -> 01235 0.45678 („0.00“, en-US) -> 0.46 0.45678 („0.00“, fr-FR) -> 0,46
"#"	Ziffernplatzhalter	Ersetzt das "#"-Symbol ggf. durch eine entsprechende vorhandene Ziffer; andernfalls wird keine Ziffer in der Ergebniszeichenfolge angezeigt. In der Ergebniszeichenfolge wird keine Ziffer angezeigt, wenn die entsprechende Ziffer in der Eingabezeichenfolge ein nicht signierter Wert 0 ist. Zum Beispiel: 0003 („####“) -> 3. Weitere Informationen finden Sie unter: Der benutzerdefinierte Spezifizierer „#“	1234.5678 („#####“) -> 1235 0.45678 („#.##“, en-US) -> .46 0.45678 („#.##“, fr-FR) -> ,46
"."	Dezimaltrennzeichen	Bestimmt die Position des Dezimaltrennzeichens in der Ergebniszeichenfolge. Weitere Informationen finden Sie unter: Der benutzerdefinierte Bezeichner ".".	0.45678 („0.00“, en-US) -> 0.46 0.45678 („0.00“, fr-FR) -> 0,46
","	Gruppentrennzeichen und Zahlenskalierung	Das Zeichen wird sowohl als Bezeichner für Gruppentrennzeichen als auch als Bezeichner für Zahlenskalierung verwendet. Bei einer Verwendung als Bezeichner für Gruppentrennzeichen wird ein lokalisiertes Trennzeichen zwischen die einzelnen Gruppen eingefügt. Bei einer Verwendung als Bezeichner für Zahlenskalierung wird eine Zahl für jedes angegebene Zeichen durch 1000 geteilt. Weitere Informationen finden Sie unter: Der benutzerdefinierte Spezifizierer „,“	Bezeichner für Gruppentrennzeichen: 2147483647 („##,#“, en-US) -> 2,147,483,647 2147483647 („##,#“, es-ES) -> 2.147.483.647 Bezeichner für Zahlenskalierung: 2147483647 („#,#,,“, en-US) -> 2,147 2147483647 („#,#,,“, es-ES) -> 2.147
"%"	Prozentplatzhalter	Multipliziert eine Zahl mit 100 und fügt ein lokalisiertes Prozentsymbol in die Ergebniszeichenfolge ein. Weitere Informationen finden Sie unter: Der benutzerdefinierte Spezifizierer „%“	0.3697 („%#0.00“, en-US) -> %36.97 0.3697 („%#0.00“, el-GR) -> %36,97 0.3697 („##.0 %“, en-US) -> 37.0 % 0.3697 („##.0 %“, el-GR) -> 37,0 %
"‰"	Promilleplatzhalter	Multipliziert eine Zahl mit 1000 und fügt ein lokalisiertes Promillesymbol in die Ergebniszeichenfolge ein. Weitere Informationen finden Sie unter: Der benutzerdefinierte Spezifizierer „‰“	0.03697 („#0.00‰“, en-US) -> 36.97‰ 0.03697 („#0.00‰“, ru-RU) -> 36,97‰
"E0" "E+0" "E-0" "E0" "E+0" "E-0"	Exponentialschreibweise	Formatiert das Ergebnis mit der Exponentialschreibweise, wenn mindestens einmal 0 (null) darauf folgt. Die Groß- oder Kleinschreibung ("E" oder "e") gibt die Schreibweise des Symbols für den Exponenten in der Ergebniszeichenfolge an. Die Anzahl der Nullen, die auf das Zeichen "E" oder auf das Zeichen "e" folgen, bestimmt die Mindestanzahl der Ziffern im Exponenten. Ein Pluszeichen (+) gibt an, dass dem Exponenten immer ein Vorzeichen vorausgeht. Ein Minuszeichen (-) gibt an, dass nur negativen Exponenten ein Vorzeichen vorausgeht. Weitere Informationen finden Sie unter: Die benutzerdefinierten Spezifizierer „E“ und „e“	987654 („#0.0e0“) -> 98.8e4 1503.92311 („0.0##e+00“) -> 1.504e+03 1.8901385E-16 („0.0e+00“) -> 1.9e-16
"\", "''", """"	Escape-Zeichen	Bewirkt, dass das nächste Zeichen oder zeichen nicht als benutzerdefinierter Formatbezeichner, sondern als Literal interpretiert wird. Weitere Informationen: Escapezeichen.	987654 („\###00\#“) -> #987654# 987654 ("#'#'#00'#'") –> #987654# 987654 ("""#"#""#00""#""") -> #987654#
'Zeichenfolge' "Zeichenfolge"	Zeichenfolgenliteraltrennzeichen	Gibt an, dass die eingeschlossenen Zeichen unverändert in die Ergebniszeichenfolge kopiert werden sollen. Weitere Informationen finden Sie unter: Zeichenliterale	68 („# 'Grad'“) -> 68 Grad 68 („#' Grad'“) -> 68 Grad
;	Abschnittstrennzeichen	Definiert Abschnitte mit separaten Formatzeichenfolgen für positive und negative Zahlen sowie Nullen. Weitere Informationen finden Sie unter: Das Abschnittstrennzeichen „;“	12.345 („#0.0#;(#0.0#);-\0-“) -> 12.35 0 („#0.0#;(#0.0#);-\0-“) -> -0- -12.345 („#0.0#;(#0.0#);-\0-“) -> (12.35) 12.345 („#0.0#;(#0.0#)“) -> 12.35 0 („#0.0#;(#0.0#)“) -> 0.0 -12.345 („#0.0#;(#0.0#)“) -> (12.35)
Andere	Alle anderen Zeichen	Das Zeichen wird unverändert in die Ergebniszeichenfolge kopiert. Weitere Informationen finden Sie unter: Zeichenliterale	68 („# °“) -> 68 °

Die folgenden Abschnitte enthalten ausführliche Informationen zu den einzelnen benutzerdefinierten Zahlenformatbezeichnern.

Der benutzerdefinierte Bezeichner „0“

Der benutzerdefinierte Formatbezeichner "0" dient als 0-Platzhalterzeichen. Wenn der zu formatierende Wert über eine Ziffer an der Stelle verfügt, an der die Ziffer 0 in der Formatzeichenfolge steht, wird diese Ziffer in die Ergebniszeichenfolge kopiert; andernfalls erscheint die Ziffer 0 in der Ergebniszeichenfolge. Die Positionen der Ziffer 0, die am weitesten links vor dem Dezimaltrennzeichen steht, und die Position der Ziffer 0, die am weitesten rechts hinter dem Dezimaltrennzeichen steht, bestimmen den Bereich der Ziffern, die immer in der Ergebniszeichenfolge enthalten sind.

Mit dem Bezeichner "00" wird der Wert immer auf die direkt dem Dezimaltrennzeichen vorausgehende Zahl aufgerundet. Eine Formatierung des Werts 34.5 mit "00" ergibt z. B. den Wert 35.

Im folgenden Beispiel werden mehrere Werte angezeigt, die mit benutzerdefinierten Formatzeichenfolgen formatiert werden, in denen 0-Platzhalter enthalten sind.

let
    Source =
    {
        Number.ToText(123, "00000", ""),
        // Displays 00123

        Number.ToText(1.2, "0.00", ""),
        // Displays 1.20

        Number.ToText(1.2, "00.00", ""),
        // Displays 01.20

        Number.ToText(1.2, "00.00", "da-DK"),
        // Displays 01,20

        Number.ToText(.56, "0.0", ""),
        // Displays 0.6

        Number.ToText(1234567890, "0,0", ""),
        // Displays 1,234,567,890

        Number.ToText(1234567890, "0,0", "el-GR"),
        // Displays 1.234.567.890

        Number.ToText(1234567890.123456, "0,0.0", ""),
        // Displays 1,234,567,890.1

        Number.ToText(1234.567890, "0,0.00", "")
        // Displays 1,234.57
    }
in
    Source

Hinweis

Der leere Textwert ("") im letzten Parameter von Number.ToText im vorherigen Beispiel bezieht sich auf die invariante Kultur.

Zurück zur Tabelle

Der benutzerdefinierte Bezeichner „#“

Der benutzerdefinierte Bezeichner "#" dient als Platzhaltersymbol für Ziffern. Wenn der zu formatierende Wert über eine Ziffer an der Stelle verfügt, an der das "#"-Symbol in der Formatzeichenfolge steht, wird diese Ziffer in die Ergebniszeichenfolge kopiert. Andernfalls wird an dieser Position nichts in der Ergebniszeichenfolge gespeichert.

Beachten Sie, dass dieser Bezeichner niemals eine Null anzeigt, die keine signifikante Ziffer ist, auch wenn null die einzige Ziffer in der Zeichenfolge ist. Es wird nur null angezeigt, wenn es sich um eine signifikante Ziffer in der angezeigten Zahl handelt.

Mit der Formatzeichenfolge "##" wird der Wert immer auf die direkt dem Dezimaltrennzeichen vorausgehende Zahl aufgerundet. Eine Formatierung des Werts 34.5 mit "##" ergibt z. B. den Wert 35.

Im folgenden Beispiel werden mehrere Werte angezeigt, die mit benutzerdefinierten Formatzeichenfolgen formatiert werden, in denen Ziffernplatzhalter enthalten sind.

let
    Source =
    {
        Number.ToText(1.2, "#.##", ""),
        // Displays 1.2

        Number.ToText(123, "#####"),
        // Displays 123

        Number.ToText(123456, "[##-##-##]"),
        // Displays [12-34-56]

        Number.ToText(1234567890, "#"),
        // Displays 1234567890

        Number.ToText(1234567890, "(###) ###-####")
        // Displays (123) 456-7890
    }
in
    Source

Wenn Sie eine Ergebniszeichenfolge zurückgeben möchten, in der keine Ziffern oder führende Nullen durch Leerzeichen ersetzt werden, verwenden Sie die Text.PadStart, und geben Sie eine Feldbreite an, wie im folgenden Beispiel dargestellt.

let
   Source = Text.Format("The value is: '#{0}'", {Text.PadStart(Number.ToText(.324, "#.###"), 5)})
in
   Source

// The example displays the following output if the current culture
// is en-US:
//      The value is: ' .324'

Zurück zur Tabelle

Der benutzerdefinierte Bezeichner „.“

Der benutzerdefinierte Formatbezeichner "." fügt ein lokalisiertes Dezimaltrennzeichen in die Ergebniszeichenfolge ein. Der erste Punkt in der Formatzeichenfolge bestimmt die Position des Dezimaltrennzeichens im formatierten Wert; alle weiteren Punkte werden ignoriert. Wenn der Formatbezeichner mit "." endet, werden nur die signifikanten Stellen als Ergebniszeichenfolge formatiert.

Das Zeichen, das als Dezimaltrennzeichen in der Ergebniszeichenfolge verwendet wird, ist nicht immer ein Punkt. sie wird durch die Kultur bestimmt, die die Formatierung steuert.

Im folgenden Beispiel wird der "."-Formatbezeichner verwendet, um die Position des Dezimalzeichens in mehreren Ergebniszeichenfolgeketten zu definieren.

let
    Source =
    {
        Number.ToText(1.2, "0.00", ""),
        // Displays 1.20

        Number.ToText(1.2, "00.00", ""),
        // Displays 01.20

        Number.ToText(1.2, "00.00", "da-DK"),
        // Displays 01,20

        Number.ToText(.086, "#0.##%", ""),
        // Displays 8.6%

        Number.ToText(Double.From(86000), "0.###E+0", "")
        // Displays 8.6E+4
    }
in
    Source

Zurück zur Tabelle

Der benutzerdefinierte Bezeichner „,“

Das Zeichen "," dient sowohl als Bezeichner für Gruppentrennzeichen als auch als Bezeichner für Zahlenskalierung.

• Gruppentrennzeichen: Wenn mindestens ein Komma zwischen zwei Ziffernplatzhaltern (0 oder #) angegeben ist, das die ganzzahligen Ziffern einer Zahl formatiert, wird zwischen jeder Zahlengruppe im ganzzahligen Teil der Ausgabe ein Gruppentrennzeichen eingefügt.

  Die Kultur bestimmt das Zeichen, das als Zahlengruppentrennzeichen und die Größe jeder Zahlengruppe verwendet wird. Wenn z. B. zum Formatieren der Zahl 1000 die Zeichenfolge "#,#" und die invariante Kultur verwendet werden, lautet die Ausgabe "1,000".

• Zahlenskalierungsspezifizierer: Wenn direkt links neben dem expliziten oder impliziten Dezimaltrennzeichen mindestens ein Komma angegeben wird, wird die zu formatierende Zahl bei jedem Vorkommen eines Kommas durch 1000 dividiert. Wenn z. B. zum Formatieren der Zahl 100 Millionen die Zeichenfolge "0,," verwendet wird, lautet die Ausgabe "100".

Sie können in der gleichen Formatzeichenfolge sowohl Bezeichner für Gruppentrennzeichen als auch für Zahlenskalierung verwenden. Wenn z. B. zum Formatieren der Zahl 1 Milliarde die Zeichenfolge "#,0,," und die invariante Kultur verwendet werden, lautet die Ausgabe "1,000".

Im folgenden Beispiel wird die Verwendung des Kommas als Gruppentrennzeichen veranschaulicht.

let
    Source =
    {
        Number.ToText(1234567890, "#,#", ""),
        // Displays 1,234,567,890

        Number.ToText(1234567890, "#,##0,,", "")
        // Displays, 1,235
    }
in
    Source

Das folgende Beispiel veranschaulicht der Verwendung des Kommas als Bezeichner für die Zahlenskalierung.

let
    Source =
    {
        Number.ToText(1234567890, "#,,", ""),
        // Displays 1235

        Number.ToText(1234567890, "#,,,", ""),
        // Displays 1

        Number.ToText(1234567890, "#,##0,,", "")
        // Displays 1,235
    }
in
    Source

Zurück zur Tabelle

Der benutzerdefinierte Bezeichner „%“

Ein Prozentzeichen (%) in einer Formatzeichenfolge bewirkt, dass eine Zahl mit 100 multipliziert wird, bevor sie formatiert wird. Das lokalisierte Prozentzeichen wird in der Zahl an der Stelle eingefügt, an der % in der Formatzeichenfolge steht. Das verwendete Prozentzeichen wird durch die Kultur definiert.

Im folgenden Beispiel wird eine benutzerdefinierte Formatzeichenfolge definiert, die den benutzerdefinierten Bezeichner "%" enthält.

let
    Source = Number.ToText(.086, "#0.##%", "")
    // Displays 8.6%
in
    Source

Zurück zur Tabelle

Der benutzerdefinierte Bezeichner „‰“

Ein Zeichen pro Mille (\ oder \u2030) in einer Formatzeichenfolge bewirkt, dass eine Zahl mit 1000 multipliziert wird, bevor sie formatiert wird. Das entsprechende Promillesymbol wird in der Rückgabezeichenfolge an der Stelle eingefügt, an der das Symbol ‰ in der Formatzeichenfolge steht. Das verwendete Zeichen pro Mille wird durch die Kultur definiert, die kulturspezifische Formatierungsinformationen bereitstellt.

Im folgenden Beispiel wird eine benutzerdefinierte Formatzeichenfolge mit dem benutzerdefinierten Bezeichner "‰" definiert.

let
    Source = Number.ToText(.00354, "#0.##" & Character.FromNumber(0x2030), "")
    // Displays 3.54‰
in
    Source

Zurück zur Tabelle

Die benutzerdefinierten Bezeichner „E“ und „e“

Wenn die Formatzeichenfolge die Zeichenfolge "E", "E+", "E-", "e", "e+" oder "e-" enthält und direkt danach mindestens einmal die Ziffer 0, wird die Zahl mit der wissenschaftlichen Notation formatiert und ein "E" bzw. "e" zwischen der Zahl und dem Exponenten eingefügt. Die Anzahl der Nullen nach dem Bezeichner für die wissenschaftliche Notation bestimmt die Mindestanzahl der Ziffern, die für den Exponenten ausgegeben werden. Das "E+"-Format und das "e+"-Format geben an, dass immer ein Vorzeichen (Plus oder Minus) vor dem Exponenten steht. Die Formate "E", "E-", "e" oder "e-" geben an, dass nur vor negativen Exponenten ein Vorzeichen steht.

Im folgenden Beispiel werden mehrere numerische Werte mit den Bezeichnern für die wissenschaftliche Notation formatiert.

let
    Source =
    {
        Number.ToText(86000, "0.###E+0", ""),
        // Displays 8.6E+4

        Number.ToText(86000, "0.###E+000", ""),
        // Displays 8.6E+004

        Number.ToText(86000, "0.###E-000", "")
        // Displays 8.6E004
    }
in
    Source

Zurück zur Tabelle

Escape-Zeichen

Die Symbole "#", "0", ".", ",", "%" und "‰" in einer Formatzeichenfolge werden als Formatbezeichner und nicht als Literalzeichen interpretiert. Je nach Position in einer benutzerdefinierten Formatzeichenfolge können auch die Groß- und Kleinbuchstaben "E" sowie die Symbole +und - als Formatbezeichner interpretiert werden.

Um zu verhindern, dass ein Zeichen als Formatbezeichner interpretiert wird, können Sie:

• Stellen Sie ihm einen umgekehrten Schrägstrich voran.
• Umschließen Sie es mit einem einzelnen Anführungszeichen.
• Umschließen Sie es mit zwei doppelten Anführungszeichen.

Jedes dieser Zeichen fungiert als Escapezeichen. Das Escapezeichen gibt an, dass das folgende Zeichen ein Zeichenliteral ist, das unverändert in der Ergebniszeichenfolge enthalten sein soll.

Um einen umgekehrten Schrägstrich in eine Ergebniszeichenfolge einzuschließen, müssen Sie diesen mit einem weiteren umgekehrten Schrägstrich versehen, der als Escapezeichen dient (\\).

Um ein einzelnes Anführungszeichen in eine Ergebniszeichenfolge einzuschließen, müssen Sie es mit einem umgekehrten Schrägstrich (\') escapen. Wenn ein weiteres einzelnes Anführungszeichen, das nicht escaped ist, vor dem escapeden einfachen Anführungszeichen steht, wird stattdessen der umgekehrte Schrägstrich angezeigt ('\' zeigt an \).

Um ein doppeltes Anführungszeichen in eine Ergebniszeichenfolge einzuschließen, müssen Sie zwei davon mit einem umgekehrten Schrägstrich (\"") escapen.

Im folgenden Beispiel werden Escapezeichen verwendet, um zu verhindern, dass der Formatierungsvorgang die Zeichen "#", "0" und "" als Escapezeichen oder Formatbezeichner interpretiert.

let
    Source =
    {
        Number.ToText(123, "\#\#\# ##0 dollars and \0\0 cents \#\#\#"),
        // Displays ### 123 dollars and 00 cents ###

        Number.ToText(123, "'###' ##0 dollars and '00' cents '###'"),
        // Displays ### 123 dollars and 00 cents ###

        Number.ToText(123, """###"" ##0 dollars and ""00"" cents ""###"""),
        // Displays ### 123 dollars and 00 cents ###

        Number.ToText(123, "\\\\\\ ##0 dollars and \0\0 cents \\\\\\"),
        // Displays \\\ 123 dollars and 00 cents \\\

        Number.ToText(123, "'\\\' ##0 dollars and '00' cents '\\\'"),
        // Displays \\\ 123 dollars and 00 cents \\\

        Number.ToText(123, """\\\"" ##0 dollars and ""00"" cents ""\\\""")
        // Displays \\\ 123 dollars and 00 cents \\\
    }
in
    Source

Zurück zur Tabelle

Das Abschnittstrennzeichen „;“

Das Semikolon (;) ist ein bedingter Formatbezeichner, der Zahlen unterschiedlich formatiert, je nachdem, ob sein Wert positiv, negativ oder 0 (null) ist. Dafür kann eine benutzerdefinierte Formatzeichenfolge bis zu drei durch Semikolons getrennte Abschnitte enthalten. Diese Abschnitte werden in der folgenden Tabelle beschrieben.

Anzahl der Abschnitte	Beschreibung
Ein Abschnitt	Die Formatzeichenfolge gilt für alle Werte.
Zwei Abschnitte	Der erste Abschnitt gilt für positive Werte und Nullen, der zweite Abschnitt für negative Werte. Wenn die zu formatierende Zahl negativ ist, aber nach dem Runden entsprechend dem Format im zweiten Abschnitt 0 ist, wird die resultierende 0 entsprechend dem ersten Abschnitt formatiert.
Drei Abschnitte	Der erste Abschnitt gilt für positive Werte, der zweite Abschnitt für negative Werte und der dritte Abschnitt für Nullen. Wenn der zweite Abschnitt leer ist (zwischen den Semikolons wird nichts angegeben), wird der erste Abschnitt auf alle Werte angewendet, die nicht 0 (null) sind. Wenn die zu formatierende Zahl nicht 0 ist, aber nach dem Runden entsprechend dem Format im ersten oder im zweiten Abschnitt 0 ist, wird die resultierende 0 entsprechend dem dritten Abschnitt formatiert.

Abschnittstrennzeichen ignorieren alle bereits vorhandenen Formatierungen für Zahlen, wenn der letzte Wert formatiert wird. Negative Werte werden z. B. immer ohne Minuszeichen angezeigt, wenn Abschnittstrennzeichen verwendet werden. Wenn der letzte formatierte Wert ein Minuszeichen aufweisen soll, muss das Minuszeichen explizit als Teil des benutzerdefinierten Formatbezeichners aufgenommen werden.

Im folgenden Beispiel wird der Formatbezeichner ";" verwendet, um positive und negative Zahlen sowie Nullen unterschiedlich zu formatieren.

let
    Source =
    {
        Number.ToText(1234, "##;(##)"),
        // Displays 1234

        Number.ToText(-1234, "##;(##)"),
        // Displays (1234)

        Number.ToText(0, "##;(##);**Zero**")
        // Displays **Zero**
    }
in
    Source

Zurück zur Tabelle

Zeichenliterale

Formatbezeichner, die in einer benutzerdefinierten numerischen Formatzeichenfolge auftreten, werden immer als Formatierungszeichen, nicht als Literalzeichen interpretiert. Dies beinhaltet die folgenden Zeichen:

• 0
• #
• %
• ‰
• '
• \
• ""
• .
• ,
• E oder e, je nach Position in der Formatzeichenfolge.

Alle anderen Zeichen werden immer als Zeichenliterale interpretiert und bei einem Formatierungsvorgang unverändert in die Ergebniszeichenfolge übernommen. In einem Analysevorgang müssen die Zeichen exakt den Zeichen in der Eingabezeichenfolge entsprechen, beim Vergleich wird die Groß- und Kleinschreibung beachtet.

In folgendem Beispiel wird eine häufige Verwendung von Literalzeicheneinheiten (in diesem Fall Tausender) veranschaulicht:

let
    Source = Number.ToText(123.8, "#,##0.0K")
    // Displays 123.8K
in
    Source

Es gibt zwei Möglichkeiten, um anzugeben, dass Zeichen nicht als Formatierungszeichen, sondern als Literalzeichen interpretiert werden sollen, damit sie in eine Ergebniszeichenfolge eingeschlossen oder in einer Eingabezeichenfolge erfolgreich analysiert werden können:

• Durch Versehen eines Formatierungszeichens mit Escapezeichen. Weitere Informationen hierzu können Sie zu Escapezeichen wechseln.

• Durch Einschließen der gesamten Literalzeichenfolge in Apostrophe.

In folgendem Beispiel werden beide Ansätze verwendet, um reservierte Zeichen in eine benutzerdefinierte numerische Formatzeichenfolge einzufügen.

let
    Source =
    {
        Number.ToText(9.3, "##.0\%"),
        // Displays 9.3%

        Number.ToText(9.3, "\'##\'"),
        // Displays '9'

        Number.ToText(9.3, "\\##\\"),
        // Displays \9\

        Number.ToText(9.3, "##.0'%'"),
        // Displays 9.3%

        Number.ToText(9.3, "'\'##'\'"),
        // Displays \9\

        Number.ToText(9.3, "##.0""%"""),
        // Displays 9.3%

        Number.ToText(9.3, "\""##\""")
        // Displays "9"
    }
in
    Source

Hinweise

Unendlichkeiten und NaN bei Gleitkommawerten

Unabhängig von der Formatzeichenfolge ist die formatierte Zeichenfolge, wenn der Wert eines Decimal.Type, Single.Type oder Double.Type Gleitkommatyp positive Unendlichkeit, negative Unendlichkeit oder keine Zahl (NaN) ist, ist die formatierte Zeichenfolge der Wert der entsprechenden Number.PositiveInfinity, Number.NegativeInfinityoder Number.NaN Konstanten, die von der aktuell anwendbaren Kultur angegeben werden.

Rundung bei Formatzeichenfolgen mit Festkomma

Bei Zeichenfolgen im Festkommaformat (d. h. Formatzeichenfolgen, die keine wissenschaftlichen Schreibformatzeichen enthalten), werden Zahlen auf so viele Dezimalstellen gerundet, wie Ziffernplatzhalter rechts vom Dezimalkomma vorhanden sind. Wenn die Formatzeichenfolge keinen Dezimalkomma enthält, wird die Zahl auf die nächste ganze Zahl gerundet. Wenn die Zahl über mehr Ziffern verfügt, als Ziffernplatzhalter links neben dem Dezimaltrennzeichen stehen, werden die zusätzlichen Ziffern direkt vor dem ersten Ziffernplatzhalter in die Ergebniszeichenfolge kopiert.

Zurück zur Tabelle

Beispiel

Im folgenden Beispiel werden zwei benutzerdefinierte numerische Formatzeichenfolgen veranschaulicht. In beiden Fällen werden die numerischen Daten durch einen Ziffernplatzhalter (#) angezeigt. Alle anderen Zeichen werden in die Ergebniszeichenfolge kopiert.

let
    Source =
    {
        Number.ToText(1234567890, "(###) ###-####"),
        // Displays (123) 456-7890

        Number.ToText(42, "My Number = #")
        // Displays My number = 42
    }
in
    Source

Zurück zur Tabelle

Zugehöriger Inhalt

• Wie sich Kultur auf die Textformatierung auswirkt
• Zahlentypkonvertierung
• Datentypen in Power Query
• Standardmäßige Zahlenformatzeichenfolgen