HOWTO · VBA

Konvertieren einer Zeichenkette in eine Zahl in VBA

Dieses Tutorial zeigt, wie Sie in VBA eine Zeichenfolge in eine Zahl konvertieren.

Auf dieser Seite

Um Text mit einer Zahl in VBA umzuwandeln, übergeben Sie ihn an die Konvertierungsfunktion für den benötigten numerischen Typ. Verwenden Sie CInt für einen 16-Bit-Integer, CLng für einen 32-Bit-Long oder eine Funktion wie CDbl, CCur oder CDec, wenn Sie einen anderen Wertebereich oder eine andere Genauigkeit benötigen. Die folgenden Beispiele zeigen die Aufrufe in VBA und die bereitgestellten Ergebnisse in Excel-Meldungsfenstern. Der VBA-Code dient nur der Veranschaulichung und wird von der Laufzeitumgebung dieser Seite nicht ausgeführt.

Eine Zeichenfolge in VBA in eine Zahl umwandeln

VBA stellt separate Konvertierungsfunktionen bereit, da Ganzzahlen, Gleitkommazahlen und Festkommawerte unterschiedliche Wertebereiche und Genauigkeiten haben. In diesem Artikel geht es um die Funktionen CByte, CInt, CLng, CSng, CDbl, CCur und CDec. Jede akzeptiert einen Wert, den VBA als Zahl interpretieren kann, und gibt den entsprechenden numerischen Typ zurück. Eine Ausnahme ist CDec: Diese Funktion gibt einen Variant mit dem Untertyp Decimal zurück.

Wählen Sie den Ergebnistyp passend zu den Daten und zur anschließenden Berechnung. Bei der Konvertierung in eine Ganzzahl wird der Nachkommaanteil durch Rundung berücksichtigt; die Dezimalstellen werden nicht einfach abgeschnitten. Für exakte Finanzberechnungen mit vier Nachkommastellen eignet sich häufig Currency. Wenn Sie einen größeren Dezimalbereich und mehr Nachkommastellen benötigen, verwenden Sie den Untertyp Decimal innerhalb eines Variant.

Die passende Konvertierungsfunktion in VBA auswählen

Funktion Ergebnis Geeignet, wenn …
CByte Byte, 0 bis 255 der Wert eine kleine, nicht negative Ganzzahl ist.
CInt Integer, −32.768 bis 32.767 eine vorzeichenbehaftete 16-Bit-Ganzzahl ausreicht.
CLng Long, −2.147.483.648 bis 2.147.483.647 Sie einen größeren Wertebereich für vorzeichenbehaftete Ganzzahlen benötigen.
CSng Single Näherungswerte mit geringerer Gleitkommagenauigkeit ausreichen.
CDbl Double Sie den größeren Wertebereich und die höhere Genauigkeit der doppelten Gleitkommagenauigkeit benötigen.
CCur Currency Sie Festkommaarithmetik mit vier Nachkommastellen benötigen, etwa für Geldbeträge.
CDec Decimal-Untertyp von Variant Sie Dezimalarithmetik mit mehr Nachkommastellen benötigen, als Currency bietet.

Integer und Long sind beide Ganzzahltypen. In VBA umfasst Integer einen 16-Bit-Wertebereich, während Long 32 Bit verwendet. Wählen Sie daher Long, wenn der mögliche Wert den Integer-Bereich überschreiten kann. Eine mit As Long deklarierte Variable ist vom Typ Long. Soll eine Variable das Ergebnis von CDec einschließlich des Decimal-Untertyps beibehalten, muss sie als Variant deklariert sein.

Zeichenfolgen in Ganzzahltypen umwandeln

Verwenden Sie CByte, CInt oder CLng, wenn das Ergebnis eine Ganzzahl sein soll. Die folgenden vollständigen Prozeduren deklarieren jeweils eine Zeichenfolge, wandeln sie um und zeigen das Ergebnis an. Fügen Sie eine Prozedur in ein Standardmodul von VBA ein und führen Sie sie in Excel aus. Diese Prozeduren in VBA werden von der Laufzeitumgebung dieser Seite nicht ausgeführt. Die bereitgestellten Bilder der Meldungsfenster zeigen die jeweiligen Ergebnisse, die zusätzlich als auswählbarer Text angegeben sind.

Für ein Ergebnis vom Typ Byte fügen Sie diese vollständige Prozedur in ein Standardmodul von VBA ein und führen Sie sie aus:

Sub ShowByte()
    Dim inputText As String
    inputText = "12"
    MsgBox CByte(inputText)
End Sub

Das Meldungsfenster zeigt 12 an.

Microsoft-Excel-Meldungsfenster mit der Anzeige 12 nach der Umwandlung der Zeichenfolge “12” mit CByte

Das Meldungsfenster zeigt 12 an, das Ergebnis von CByte("12").

Für eine vorzeichenbehaftete Ganzzahl fügen Sie diese vollständige Prozedur ein und führen Sie sie aus:

Sub ShowInteger()
    Dim inputText As String
    inputText = "12.5"
    MsgBox CInt(inputText)
End Sub

Das Meldungsfenster zeigt 12 an. Hier wird auf die nächste gerade Zahl gerundet: Liegt der Bruchteil genau in der Mitte zwischen zwei Ganzzahlen, ist das Ergebnis die gerade Zahl. Dieselbe Rundungsregel erklärt, warum CInt("13.5") zu 14 wird. Integer-Werte müssen zwischen −32.768 und 32.767 liegen; außerhalb dieses Bereichs verursacht CInt einen Überlauf.

Microsoft-Excel-Meldungsfenster mit der Anzeige 12 nach der Umwandlung der Zeichenfolge “12.5” mit CInt

Das Meldungsfenster zeigt für CInt("12.5") den Wert 12 an; dieser Halbwert wurde auf die nächste gerade Ganzzahl gerundet.

Wählen Sie CLng für größere Ganzzahlen. Fügen Sie diese vollständige Prozedur ein und führen Sie sie aus:

Sub ShowLong()
    Dim inputText As String
    inputText = "15.7"
    MsgBox CLng(inputText)
End Sub

Das Meldungsfenster zeigt 16 an, weil der Bruchteil auf die nächste Ganzzahl gerundet wird. Der unterstützte Wertebereich reicht von −2.147.483.648 bis 2.147.483.647.

Microsoft-Excel-Meldungsfenster mit der Anzeige 16 nach der Umwandlung der Zeichenfolge “15.7” mit CLng

Das Meldungsfenster zeigt 16 an, das Ergebnis von CLng("15.7").

Zeichenfolgen in Gleitkommatypen umwandeln

CSng wandelt in Single-Genauigkeit um, CDbl in Double-Genauigkeit. Gleitkommazahlen können einen deutlich größeren Wertebereich als Ganzzahltypen abdecken. Viele Dezimalbrüche lassen sich im binären Gleitkommaformat jedoch nur näherungsweise darstellen. Verlassen Sie sich bei Berechnungen mit solchen Brüchen nicht auf exakte Gleichheit, sondern verwenden Sie beim Vergleich berechneter Ergebnisse eine Toleranz.

Fügen Sie diese vollständige Prozedur ein und führen Sie sie aus, um in Single umzuwandeln:

Sub ShowSingle()
    Dim inputText As String
    inputText = "1.3"
    MsgBox CSng(inputText)
End Sub

Das Meldungsfenster zeigt 1.3 an. Die angezeigte Dezimalzahl bedeutet nicht, dass jede interne Gleitkommaberechnung exakt ist.

Microsoft-Excel-Meldungsfenster mit der Anzeige 1.3 nach der Umwandlung der Zeichenfolge “1.3” mit CSng

Das Meldungsfenster zeigt 1.3 an, das Ergebnis von CSng("1.3").

Verwenden Sie CDbl, wenn Single nicht genau genug ist oder die Berechnung den größeren Double-Wertebereich benötigt. Beide Funktionen liefern näherungsweise binäre Gleitkommawerte. Wenn die Anzahl der Dezimalstellen wichtiger ist als der Gleitkommabereich, wählen Sie stattdessen CCur oder CDec. Um ein Double-Ergebnis in Excel anzuzeigen, fügen Sie diese vollständige Prozedur ein und führen Sie sie aus:

Sub ShowDouble()
    Dim inputText As String
    inputText = "123.45"
    MsgBox CDbl(inputText)
End Sub

Das angezeigte Zahlenformat kann von den regionalen Einstellungen abhängen.

Zeichenfolgen in Currency und Decimal umwandeln

CCur gibt einen Wert vom Typ Currency zurück, einem Festkommatyp mit vier Nachkommastellen. Sein Wertebereich reicht von −922.337.203.685.477,5808 bis 922.337.203.685.477,5807. Currency eignet sich daher für viele Geldberechnungen, bei denen eine feste Genauigkeit von vier Nachkommastellen angemessen ist. Werte mit mehr als vier Nachkommastellen werden auf diese Genauigkeit gerundet. Um eine Currency-Konvertierung anzuzeigen, fügen Sie diese vollständige Prozedur ein und führen Sie sie aus:

Sub ShowCurrency()
    Dim inputText As String
    inputText = "12.34"
    MsgBox CCur(inputText)
End Sub

CDec gibt einen Variant mit dem Untertyp Decimal zurück; VBA bietet Decimal nicht als eigenständigen Variablendeklarationstyp an. Decimal unterstützt bis zu 28 Nachkommastellen und Werte bis ungefähr ±7,9228 × 10^28; die verfügbare Anzahl der Nachkommastellen hängt von der Größenordnung ab. Wenn nachfolgende Berechnungen die Decimal-Genauigkeit bewahren sollen, speichern Sie das Ergebnis in einem Variant. Die folgende Prozedur weist den konvertierten Wert vor der Anzeige einem Variant zu:

Sub ShowDecimal()
    Dim inputText As String
    Dim result As Variant
    inputText = "12.3456"
    result = CDec(inputText)
    MsgBox result
End Sub

Rundung, Gebietsschema und Konvertierungsfehler verstehen

Die Konvertierungsfunktionen in VBA interpretieren numerischen Text anhand der regionalen Einstellungen des Computers, einschließlich Dezimal- und Tausendertrennzeichen. Eine Zeichenfolge mit Dezimalkomma kann auf einem anderen System anders interpretiert werden als erwartet. Wenn die Eingabe aus einer Datei, einer API oder von einem Nutzer stammt und einem bekannten Format folgt, vereinheitlichen oder prüfen Sie dieses Format vor der Konvertierung. Gehen Sie nicht davon aus, dass jeder Computer dieselben Trennzeichen verwendet.

Die Rundung auf die nächste gerade Zahl kann für Leser überraschend sein, die erwarten, dass Halbwerte immer aufgerundet werden. Pythons eingebaute Funktion round folgt in diesem Beispiel derselben Regel. Die folgende Demonstration veranschaulicht das Rundungsprinzip; sie führt VBA nicht aus:

Führen Sie diese Python-Demonstration zur Rundung aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

print(round(12.5))
12

Eine nicht numerische Zeichenfolge verursacht einen Typkonflikt. Liegt ein Zahlenwert außerhalb des Wertebereichs des Zieltyps, kommt es zu einem Überlauf. Prüfen Sie Benutzereingaben vor der Konvertierung und behandeln Sie Konvertierungsfehler möglichst direkt am Funktionsaufruf, damit die Anwendung erklären kann, welcher Wert korrigiert werden muss. Eine reine Prüfung, ob ein Wert numerisch ist, stellt nicht sicher, dass er in Byte, Integer oder Long passt. Vor der Zuweisung zu einem engeren Typ muss der Wertebereich daher zusätzlich geprüft werden.