Bei Konvertierungen zwischen Zeichenfolgen und numerischen Datentypen können Sie im FORMAT-Parameter der CAST-Funktion einen optionalen Formatierungsausdruck verwenden.
Bei Konvertierungen von Zeichenfolgen bestimmt der Formatierungsausdruck, wie die Syntax der Quellenzeichenfolge analysiert werden soll, um den Zieldatentyp zu füllen.
Bei Konvertierungen in Zeichenfolgen legt der Formatausdruck fest, wie die Daten im Quellausdruck in der Zielzeichenfolge formatiert werden sollen.
>>-| Untermuster |--+--------------------+----------------------> '-;--| Untermuster |-' >--+-------------------+--+-----------------+------------------>< '-:groupsep=--chars-' '-:decsep=--chars-' Untermuster |--+-------+--digits--+---------+--+---------------+------------> '-chars-' '-.digits-' '-+-e-+--digits-' '-E-' >--+-------+----------------------------------------------------| '-chars-'
Eine Folge von null oder mehr Zeichen. Sie können alle Zeichen verwenden, ausgenommen die unter Untermuster aufgeführten Sonderzeichen.
Ein oder mehr Zeichen, die als Trennzeichen zwischen der ganzen Zahl und den Dezimalstellen der Zahl verwendet werden sollen (das Dezimaltrennzeichen). Standardmäßig wird der Punkt (.) als Dezimaltrennzeichen verwendet.
Eine Folge von einem oder mehreren numerischen Token (0 # - + , . ), die unter Untermuster aufgelistet sind.
Ein oder mehr Zeichen, die als Trennzeichen zwischen Clustern von Ganzzahlen verwendet werden, um lange Zahlen lesbarer zu machen (das Blocktrennzeichen). Es gibt kein Standardblocktrennzeichen (d. h., es gibt keine Gruppierung von Ziffern oder Trennung von Gruppen).
Wenn Sie mehrere Blocktrennzeichen verwenden (wie im vorherigen Beispiel), definiert das Trennzeichen ganz rechts die primäre Größe und das vorletzte rechte Trennzeichen die sekundäre Größe.
Token | Steht für |
---|---|
0 | Jede Ziffer einschließlich einer führenden Null. |
# | Jede Ziffer ausschließlich einer führenden Null. (Siehe Erläuterung des Unterschieds zwischen 0 und # weiter unten.) |
. | Dezimaltrennzeichen. |
+ | Präfix positiver Zahlen. |
- | Präfix negativer Zahlen. |
, | Blocktrennzeichen. |
E/e | Trennt die Zahl vom Exponenten. |
; | Untermustergrenzwert. |
' | Anführungszeichen, gilt für Sonderzeichen. Verwenden Sie in Ausgaben doppelte Anführungszeichen (''). |
* | Auffüllkennung. Das Zeichen nach dem Sternchen dient zur Auffüllung der Zahl, um die Länge dem Formatierungsmuster anzupassen. |
Die Zeichen # und 0 werden für den Austausch von Ziffern verwendet. Sie unterscheiden sich darin, dass das Zeichen # entfernt wird, wenn es nicht durch eine Zahl ersetzt wird. Wenn z. B. die Zahl 10 mit dem Muster #,##0.00 formatiert wird, sieht das Ergebnis wie folgt aus: "10.00". Wird sie mit dem Muster 0,000.00 formatiert, lautet das Ergebnis "0,010.00".
Verwenden Sie zur Angabe von Auffüllzeichen ein Sternchen. Wenn ein Sternchen in eine der beiden chars-Bereiche (Präfix und Suffix) platziert wird, dienen die Zeichen, die direkt auf das Sternchen folgen, zum Auffüllen der Ausgabe. Das Auffüllen kann nur ein Mal festgelegt werden. Wird z. B. das Muster *x#,###,##0.00 auf die Zahl 1234 angewendet, lautet das Ergebnis: "xxx1,234.00". Wird es auf die Zahl 1234567 angewendet, ergibt es "1,234,567.00".
In der folgenden Tabelle finden Sie Formatierungsmuster und die Zeichenfolgen, die aus der numerischen Beispielausgabe generiert wurden.
Muster | Eingabezahl | Ausgabezeichenfolge |
---|---|---|
+###,##0.00;-###,###,##0.00:groupsep='':decsep=, | 123456789.123 | "+123'456'789,12" |
##0.00 | 1000000 | "1000000.00" |
##0.00 | 3.14159265 | "3.14" |