Bei Konvertierungen zwischen Zeichenfolgedatentypen und numerischen Datentypen kann im FORMAT-Parameter der CAST-Funktion ein optionaler Formatierungsausdruck angegeben werden.
Bei Konvertierungen aus Zeichenfolgetypen legt der Formatierungsausdruck fest, wie die Quellenzeichenfolge syntaktisch analysiert werden soll, um den Zieldatentyp zu füllen.
Bei Konvertierungen in Zeichenfolgetypen bestimmt der Formatierungsausdruck, wie die Daten im Quellenausdruck in der Zielzeichenfolge formatiert werden sollen.
Eine Folge von null oder mehr Zeichen. Sie können alle Zeichen außer den unter Untermuster aufgeführten Sonderzeichen verwenden.
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 aufgeführt 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).
Bei Verwendung mehrerer Blocktrennzeichen (wie im vorherigen Beispiel) definiert das Trennzeichen ganz rechts die primäre Größe und das Trennzeichen unmittelbar daneben 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 für Sonderzeichen. Wenn in der Ausgabe ein Anführungszeichen gesetzt werden muss, ist dieses zu verdoppeln (''). |
* | 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 1234 angewandt, ergibt dies "xxx1,234.00". Bei Anwendung auf die Zahl 1234567 lautet das Ergebnis "1,234,567.00".
In der folgenden Tabelle sind Formatierungsmuster sowie die Zeichenfolgen aufgeführt, die sich aus der numerischen Mustereingabe ergeben.
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" |