Freigeben über


Benutzerdefinierte numerische Formate (Format-Funktion)

Aktualisiert: November 2007

In der folgenden Tabelle werden Zeichen aufgeführt, die zur Erstellung von benutzerdefinierten Zahlenformaten geeignet sind. Diese können zur Erstellung des Style-Arguments für die Format-Funktion verwendet werden:

Zeichen

Beschreibung

Keines

Zeigt die Zahl ohne Formatierung.

(0)

Ziffernplatzhalter. Zeigt eine Ziffer oder eine 0. Wenn der Ausdruck eine Ziffer an der Stelle aufweist, an der in der Formatzeichenfolge die 0 erscheint, wird sie angezeigt. Andernfalls wird an dieser Stelle eine 0 angezeigt.

Wenn die Zahl weniger Ziffern aufweist als Nullen (auf beiden Seiten des Dezimaltrennzeichens) im Formatausdruck enthalten sind, werden führende oder nachfolgende Nullen angezeigt. Wenn die Zahl rechts vom Dezimaltrennzeichen mehr Ziffern aufweist als Nullen rechts vom Dezimaltrennzeichen im Formatausdruck stehen, wird die Zahl auf genauso viele Dezimalstellen wie Nullen gerundet. Wenn die Zahl links vom Dezimaltrennzeichen mehr Ziffern aufweist als Nullen links vom Dezimaltrennzeichen im Formatausdruck stehen, werden die zusätzlichen Ziffern unverändert angezeigt.

(#)

Ziffernplatzhalter. Zeigt eine Ziffer oder nichts an. Wenn der Ausdruck eine Ziffer an der Stelle aufweist, an der in der Formatzeichenfolge das #-Zeichen erscheint, wird sie angezeigt. Andernfalls wird an dieser Stelle nichts angezeigt.

Dieses Symbol verhält sich wie der Ziffernplatzhalter 0. Ausnahme: Es werden keine führenden und nachfolgenden Nullen angezeigt, wenn die Zahl weniger Ziffern aufweist als es #-Zeichen auf beiden Seiten des Dezimaltrennzeichens im Formatausdruck gibt.

(.)

Dezimalzeichenplatzhalter. Mit dem Dezimalzeichenplatzhalter wird festgelegt, wie viele Ziffern links und rechts vom Dezimaltrennzeichen angezeigt werden. Wenn der Formatausdruck nur #-Zeichen links von diesem Symbol aufweist, beginnen Zahlen, die kleiner als 1 sind, mit einem Dezimaltrennzeichen (üblich im US-Zahlensystem). Damit in diesem Fall eine führende 0 angezeigt wird, verwenden Sie 0 als ersten Ziffernplatzhalter links vom Dezimaltrennzeichen. In manchen Gebietsschemas wird ein Komma als Dezimaltrennzeichen verwendet. Es hängt vom Zahlenformat ab, das in den Systemeinstellungen angegeben wurde, welches Dezimaltrennzeichen tatsächlich in der formatierten Ausgabe verwendet wird. Deshalb sollten Sie in Formaten immer einen Punkt als Dezimaltrennzeichen verwenden, selbst wenn in dem Gebietsschema ein Komma als Dezimaltrennzeichen gilt. Die formatierte Zeichenfolge wird entsprechend dem Gebietsschema richtig dargestellt.

(%)

Prozentplatzhalter. Multipliziert den Ausdruck mit 100. Das Prozentzeichen (%) wird an der Stelle eingefügt, an der es in der Formatzeichenfolge erscheint.

(,)

Tausendertrennzeichen. Bei Zahlen mit vier oder mehr Stellen links vom Dezimaltrennzeichen wird die Tausenderstelle mit einem Dezimaltrennzeichen von der Hunderterstelle getrennt. Das Tausendertrennzeichen wird standardmäßig verwendet, wenn das Format ein Tausendertrennzeichen enthält, das von Ziffernplatzhaltern (0 oder #) umgeben ist.

Wenn ein Tausendertrennzeichen unmittelbar links vom Dezimaltrennzeichen steht (unabhängig davon, ob eine Dezimalzahl angegeben ist) bzw. an der äußersten rechten Stelle in der Zeichenfolge, hat dies folgende Bedeutung: "Zahl durch 1000 dividieren bzw. skalieren und, falls erforderlich, runden." Zahlen, die kleiner als 1.000 und größer als oder gleich 500 sind, werden als 1 angezeigt, während Zahlen, die kleiner als 500 sind, als 0 angezeigt werden. Zwei aufeinander folgende Tausendertrennzeichen an dieser Stelle skalieren um den Faktor 1 Million und jedes weitere Trennzeichen um einen weiteren Faktor 1.000.

Wenn mehrere Trennzeichen nicht unmittelbar links vom Dezimaltrennzeichen oder an der äußersten rechten Stelle der Zeichenfolge stehen, werden sie als normales Tausendertrennzeichen behandelt. In manchen Gebietsschemas wird ein Punkt als Tausendertrennzeichen verwendet. Welches Tausendertrennzeichen tatsächlich in der formatierten Ausgabe verwendet wird, hängt vom Zahlenformat ab, das in den Systemeinstellungen angegeben wurde. Deshalb sollten Sie in Formaten immer ein Komma als Tausendertrennzeichen verwenden, selbst wenn in dem Gebietsschema ein Punkt als Tausendertrennzeichen gilt. Die formatierte Zeichenfolge wird entsprechend dem Gebietsschema richtig dargestellt.

Betrachten Sie z. B. die drei folgenden Formatzeichenfolgen:

  • "#,0." verwendet das Tausendertrennzeichen, um die Zahl 100 Millionen als Zeichenfolge "100,000,000" zu formatieren.

  • "#0,." verwendet eine Skalierung um den Faktor Eintausend, um die Zahl 100 Millionen als Zeichenfolge "100000" zu formatieren.

  • "#,0,." verwendet das Tausendertrennzeichen und eine Skalierung um den Faktor Eintausend, um die Zahl 100 Millionen als Zeichenfolge "100,000" zu formatieren.

(:)

Trennzeichen für Zeitangaben. In manchen Gebietsschemas können hierfür andere Zeichen verwendet werden. Mit diesem Trennzeichen werden bei formatierten Zeitangaben Stunden, Minuten und Sekunden voneinander getrennt. Es hängt von den Systemeinstellungen ab, welches Trennzeichen tatsächlich in der formatierten Ausgabe verwendet wird.

(/)

Trennzeichen für Datumsangaben. In manchen Gebietsschemas können hierfür andere Zeichen verwendet werden. Mit diesem Trennzeichen werden bei formatierten Datumsangaben Tag, Monat und Jahr voneinander getrennt. Es hängt von den Systemeinstellungen ab, welches Datumstrennzeichen tatsächlich in der formatierten Ausgabe verwendet wird.

(E-E+e-e+)

Wissenschaftliches Format. Wenn der Formatausdruck mindestens einen Ziffernplatzhalter (0 oder #) links von E-, E+, e- oder e+ enthält, wird die Zahl im wissenschaftlichen Format angezeigt und E oder e wird zwischen der Zahl und ihrem Exponenten eingefügt. Die Anzahl der Ziffernplatzhalter auf der linken Seite bestimmt die Anzahl der Ziffern im Exponenten. Verwenden Sie E- oder e-, um ein Minuszeichen bei negativen Exponenten einzufügen. Verwenden Sie E+ oder e+, um ein Minuszeichen bei negativen Exponenten und ein Pluszeichen bei positiven Exponenten einzufügen. Sie erhalten nur dann eine richtige Formatierung, wenn Sie rechts von diesem Symbol Ziffernplatzhalter verwenden.

-+$ ( )

Literalzeichen. Diese Zeichen werden genau so angezeigt, wie sie in der Formatzeichenfolge eingegeben werden. Wenn Sie ein anderes als eines der angegebenen Zeichen anzeigen möchten, stellen Sie einen umgekehrten Schrägstrich (\) vor das Zeichen oder setzen es in doppelte Anführungszeichen (" ").

(\)

Zeigt das nächste Zeichen in der Formatzeichenfolge an. Wenn Sie ein Zeichen anzeigen möchten, das eine besondere Bedeutung als Literalzeichen besitzt, stellen Sie einen umgekehrten Schrägstrich (\) voran. Der umgekehrte Schrägstrich wird nicht angezeigt. Statt den umgekehrten Schrägstrich zu verwenden, können Sie das nächste Zeichen auch in doppelte Anführungszeichen setzen. Zur Anzeige eines umgekehrten Schrägstrichs geben Sie zwei umgekehrte Schrägstriche (\\) ein.

Zu den Zeichen, die nicht als Literalzeichen angezeigt werden können, gehören die Zeichen zum Formatieren des Datums und der Uhrzeit (a, c, d, h, m, n, p, q, s, t, w, y, / und :), die Zeichen zum Formatieren von Zahlen (#, 0, %, E, e, Komma und Punkt) und die Zeichen zum Formatieren von Zeichenfolgen (@, &, <, > und !).

("ABC")

Zeigt die Zeichenfolge in den doppelten Anführungszeichen (" "). Wenn Sie im Style-Argument eine Zeichenfolge aus dem Code einfügen möchten, verwenden Sie Chr(34), um den Text zu übernehmen (34 ist der Zeichencode für ein Anführungszeichen(")).

Beispiel

In der folgenden Tabelle sind einige Beispielformatausdrücke für Zahlen aufgeführt. (Bei diesen Beispielen wird vorausgesetzt, dass Sie English-U.S. als Gebietsschema ausgewählt haben.) Die erste Spalte enthält die Formatzeichenfolgen für das Style-Argument der Format-Funktion, die anderen Spalten enthalten die jeweilige Ausgabe für die formatierten Daten bei Verwendung des in der Spaltenüberschrift angegebenen Werts.

Format (Style).

"5" formatiert als

"-5" formatiert als

"0,5" formatiert als

Zero-length string ("")

5

-5

0.5

0

5

-5

1

0.00

5.00

-5.00

0.50

#,##0

5

-5

1

$#,##0;($#,##0)

$5

($5)

$1

$#,##0.00;($#,##0.00)

$5.00

($5.00)

$0.50

0%

500%

-500%

50%

0.00%

500.00%

-500.00%

50.00%

0.00E+00

5.00E+00

-5.00E+00

5.00E-01

0.00E-00

5.00E00

-5.00E00

5.00E-01

Voraussetzungen

Namespace:Microsoft.VisualBasic

**Modul:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

Zeichenfolgenbearbeitung: Zusammenfassung

Konvertierung: Zusammenfassung

Verschiedene Formate für verschiedene numerische Werte (Format-Funktion)

Format-Funktion

Vordefinierte numerische Formate (Format-Funktion)

Benutzerdefinierte Datums-/Zeitformate (Format-Funktion)