Office: Typumwandlungsfunktionen

Typumwandlungsfunktionen
Access für Microsoft 365 Access 2019 Access 2016 Access 2013 Access 2010 Access 2007 Mehr... Weniger Jede Funktion wandelt einen Ausdruck in einen bestimmten Datentyp um.

Syntax

CBool( Ausdruck )

CByte( Ausdruck )

CCur( Ausdruck )

CDate( Ausdruck )

CDbl( Ausdruck )

CDec( Ausdruck )

CInt( Ausdruck )

CLng( Ausdruck )

CSng( Ausdruck )

CStr( Ausdruck )

CVar( Ausdruck )

Das erforderliche ArgumentAusdruck ist ein Zeichenfolgenausdruck oder ein Numerischer Ausdruck.

Rückgabetypen

Der Funktionsname bestimmt den Rückgabetyp (siehe folgende Tabelle):

Funktion	Rückgabetyp	Bereich für das Argument Ausdruck
CBool	Boolean	Beliebiger gültiger Zeichenfolgen- (string) oder numerischer Ausdruck.
CByte	Byte	0 bis 255.
CCur	Currency	-922.337.203.685.477,5808 bis 922.337.203.685.477,5807.
CDate	Date	Beliebiger gültiger Datumsausdruck.
CDbl	Double	-1,79769313486231E308 bis -4,94065645841247E-324 für negative Werte; 4,94065645841247E-324 bis 1,79769313486232E308 für positive Werte.
CDec	Decimal	+/-79.228.162.514.264.337.593.543.950.335 für unskalierte Zahlen (d. h. Zahlen ohne Dezimalstellen). Für Zahlen mit 28 Dezimalstellen lautet der Bereich +/-7,9228162514264337593543950335. Die kleinstmögliche Zahl mit Dezimalstellen ist 0,0000000000000000000000000001.
CInt	Integer	-32.768 bis 32.767; Brüche werden gerundet.
CLng	Long	-2.147.483.648 bis 2.147.483.647; Brüche werden gerundet.
CSng	Single	-3,402823E38 bis -1,401298E-45 für negative Wert und 1,401298E-45 bis 3,402823E38 für positive Werte.
CStr	String	Die jeweilige Rückgabe für "CStr" hängt vom Argument Ausdruck ab.
CVar	Variant	Derselbe Bereich wie für den Datentyp Double für numerische Werte. Derselbe Bereich wie für den Datentyp String für nicht numerische Werte.

Hinweise

Liegt der Ausdruck, der an eine Funktion übergeben wird, außerhalb des Bereichs des Datentyps, in den konvertiert werden soll, tritt ein Fehler auf.

Grundsätzlich können Sie Ihren Code mit Funktionen zur Datentypumwandlung dokumentieren, um zu kennzeichnen, dass das Ergebnis eines Vorgangs mit einem bestimmten Datentyp und nicht mit einem Standarddatentyp angezeigt werden soll. Verwenden Sie beispielsweise CCur, um Währungsarithmetik für Fälle zu erzwingen, in denen normalerweise Arithmetik mit einfacher oder doppelter Genauigkeit oder Ganzzahlarithmetik auftreten würde.

Sie sollten die Funktionen zur Datentypumwandlung anstelle von Val verwenden, um für internationale Zusammenhänge geeignete Umwandlungen von einem Datentyp in einen anderen zur Verfügung zu stellen. Wenn Sie beispielsweise CCur verwenden, werden unterschiedliche Dezimaltrennzeichen, Tausendertrennzeichen und Währungsoptionen je nach Gebietsschemaeinstellung Ihres Computers richtig erkannt.

Wenn der jeweilige Bruchteil genau 0,5 beträgt, runden CInt und CLng ihn immer auf die nächste gerade Zahl. Beispielsweise wird 0,5 auf 0 und 1,5 auf 2 gerundet. CInt und CLng unterscheiden sich von den Funktionen Fix und Int, die den Bruchteil einer Zahl nicht runden, sondern abschneiden. Außerdem geben Fix und Int immer einen Wert zurück, dessen Typ mit dem des eingegebenen Werts identisch ist.

Verwenden Sie die IsDate-Funktion, um zu ermitteln, ob Datum in ein Datum oder eine Uhrzeit umgewandelt werden kann. CDate erkennt Datumsliterale und Uhrzeitliterale sowie einige Zahlen, die in den Bereich zulässiger Datumsangaben fallen. Beim Umwandeln einer Zahl in ein Datum wird der ganzzahlige Teil der Zahl in ein Datum umgewandelt. Der Bruchteil der Zahl wird in eine Tageszeit umgewandelt, die um Mitternacht beginnt.

CDate erkennt Datumsformate entsprechend den Gebietsschemaeinstellungen Ihres System. Die richtige Reihenfolge von Tag, Monat und Jahr kann möglicherweise nicht ermittelt werden, wenn ein Datumswert in einem Format bereitgestellt wird, das keiner der erkannten Datumseinstellungen entspricht. Außerdem wird ein langes Datumsformat nicht erkannt, wenn es auch die Zeichenfolge für den Wochentag enthält.

Aus Gründen der Kompatibilität mit früheren Versionen von Visual Basic wird außerdem die CVDate-Funktion bereitgestellt. Die Syntax der CVDate-Funktion ist identisch mit derjenigen der CDate-Funktion, CVDate gibt aber einen Variant-Wert, der den Untertyp Date hat, statt eines Wert mit Date-Typ zurück. Da es nun den systeminternen Date-Typ gibt, wird CVDate nicht mehr benötigt. Derselbe Effekt lässt sich erzielen, indem ein Ausdruck in einen Date-Wert umgewandelt und dieser anschließend einem Variant-Wert zugewiesen wird. Diese Vorgehensweise entspricht der Umwandlung aller anderen systeminternen Typen in ihre gleichwertigen Variant-Untertypen.

Hinweis:  Die CDec-Funktion gibt keinen Wert mit einem einzelnen Datentyp, sondern immer einen Variant-Wert zurück, der in den Decimal-Untertyp umgewandelt wurde.

Abfragebeispiele

Ausdruck	Ergebnisse
Wählen Sie SalePrice, FinalPrice, CBool (SalePrice>FinalPrice) als expr1 von productSales aus;	Gibt "SalePrice", "FinalPrice" zurück und wertet aus, wenn SalePrice größer als der endgültige Preis ist. Gibt "-1" zurück, wenn "true" und "0", wenn false.
Wählen Sie ProductID, CByte (Quantity) As expr1 from productSales;	Gibt "ProductID" zurück, wandelt die Werte im Feld "Quantity" in das Byte-Format um und zeigt in der Spalte expr1 "ProductID" zurück, wandelt die Werte im Feld "Quantity" in das Währungsformat um und zeigt Sie in der Spalte expr1 an.
Wählen Sie ProductID, CDate (DateofSale) als expr1 von productSales;	Gibt "ProductID" zurück, wandelt die Werte im Feld "DateofSale" in das Datumsformat um und zeigt Sie in der Spalte expr1 an.
Wählen Sie ProductID, CDbl (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, konvertiert die Werte im Feld "Rabatt" in das doppelte Format und wird in der Spalte expr1 angezeigt.
Wählen Sie ProductID, CInt (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, konvertiert die Werte im Feld "Discount" in das ganzzahlige Format und wird in der Spalte expr1 angezeigt.
Wählen Sie ProductID, CLng (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, wandelt die Werte im Feld "Rabatt" in das lange Format um und zeigt in der Spalte expr1.
Wählen Sie ProductID, CSng (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, konvertiert die Werte im Feld "Rabatt" in ein einzelnes Format und wird in der Spalte expr1 angezeigt.
Wählen Sie ProductID, CStr (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, wandelt die Werte im Feld "Discount" in das Zeichenfolgenformat um und zeigt in der Spalte expr1.
Wählen Sie ProductID, CVAR (Discount) As expr1 from productSales;	Gibt "ProductID" zurück, konvertiert die Werte im Feld "Skonto" in Double für numerische Werte und Zeichenfolge für nicht numerische Werte.

VBA-Beispiele
Hinweis: Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.

CBool-Funktion
Tipp:  Seit Access 2010 unterstützt der Ausdrucks-Generator mit IntelliSense Sie dabei, Ausdrücke korrekt einzugeben.

In diesem Beispiel wird die CBool-Funktion verwendet, um einen Ausdruck in einen Boolean-Wert umzuwandeln. Hat der Ausdruck einen Wert ungleich null, gibt CBool den Wert True, andernfalls den Wert False zurück.

CByte-Funktion
In diesem Beispiel wird die CByte-Funktion verwendet, um einen Ausdruck in einen Byte-Wert umzuwandeln.

CCur-Funktion
In diesem Beispiel wird die CCur-Funktion verwendet, um einen Ausdruck in einen Currency-Wert umzuwandeln.

CDate-Funktion
In diesem Beispiel wird die CDate-Funktion verwendet, um einen Ausdruck in einen Date-Wert umzuwandeln. Im Grundsatz empfiehlt es sich nicht, Datums- und Uhrzeitangaben als feste Zeichenfolgen (wie im folgenden Beispiel gezeigt) zu codieren. Verwenden Sie stattdessen Datums- und Zeitliterale, z. B. #2/12/1969 # und #16:45:23#.

CDbl-Funktion
In diesem Beispiel wird die CDbl-Funktion verwendet, um einen Ausdruck in einen Double-Wert umzuwandeln.

CDec-Funktion
In diesem Beispiel wird die CDec-Funktion verwendet, um einen Ausdruck in einen Decimal-Wert umzuwandeln.

CInt-Funktion
In diesem Beispiel wird die CInt-Funktion verwendet, um einen Ausdruck in einen Integer-Wert umzuwandeln.

CLng-Funktion
In diesem Beispiel wird die CLng-Funktion verwendet, um einen Ausdruck in einen Long-Wert umzuwandeln.

CSng-Funktion
In diesem Beispiel wird die CSng-Funktion verwendet, um einen Ausdruck in einen Single-Wert umzuwandeln.

CStr-Funktion
In diesem Beispiel wird die CStr-Funktion verwendet, um einen Ausdruck in einen String-Wert umzuwandeln.

CVar-Funktion
In diesem Beispiel wird die CVar-Funktion verwendet, um einen Ausdruck in einen Variant-Wert umzuwandeln.

Hinweis:  Diese Seite wurde automatisiert übersetzt und kann Grammatikfehler oder Ungenauigkeiten enthalten. Unser Ziel ist es, Ihnen hilfreiche Inhalte bereitzustellen. Lassen Sie uns bitte wissen, ob diese Informationen hilfreich für Sie waren. Hier finden Sie den englischen Artikel als Referenz.

:)