CAST und CONVERT (Transact-SQL) - SQL Server (2023)

Gilt für: SQL Server (alle unterstützten Versionen) Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Mit diesen Funktionen wird ein Ausdruck von einem Datentyp in einen anderen konvertiert.

Syntax

CAST-Syntax:

CAST ( expression AS data_type [ ( length ) ] )

CONVERT-Syntax:

CONVERT ( data_type [ ( length ) ] , expression [ , style ] )

Transact-SQL-Syntaxkonventionen

Argumente

expression

Beliebiger gültiger Ausdruck.

data_type

Der Zieldatentyp. Dazu gehören xml, bigint und sql_variant. Aliasdatentypen können nicht verwendet werden.

length

Eine optionale ganze Zahl, die die Länge des Zieldatentyps angibt, falls eine vom Benutzer angegebene Länge für den Datentyp zulässig ist. Der Standardwert ist 30.

style

Ein ganzzahliger Ausdruck, der angibt, wie die CONVERT-Funktion expression übersetzt. Bei dem Formatwert NULL wird NULL zurückgegeben. data_type bestimmt den Bereich.

Rückgabetypen

Gibt expression zurück, der in data_type übersetzt wurde.

Datums- und Uhrzeitformate

Bei dem Datums- oder Uhrzeitdatentyp expression kann style einer der in der folgenden Tabelle aufgelisteten Werte sein. Andere Werte werden als 0 verarbeitet. Ab SQL Server 2012 (11.x) sind die einzigen Formate, die bei der Konvertierung von Datums- und Uhrzeittypen in datetimeoffset unterstützt werden, 0 oder 1. Bei allen anderen Konvertierungsformaten wird der Fehler 9809 zurückgegeben.

¹ Diese Formatwerte geben nicht deterministische Ergebnisse zurück. Dazu gehören alle yy-Formate (ohne Jahrhundert) und eine Teilmenge der yyyy-Formate (mit Jahrhundert).

² Die Standardwerte (0 oder 100, 9 oder 109, 13 oder 113, 20 oder 120, 23 und 21, 25 oder 121) geben immer das Jahrhundert (yyyy) zurück.

³ Eingabe, wenn in datetime konvertiert wird; Ausgabe, wenn in Zeichendaten konvertiert wird.

⁴ Vorgesehen für XML-Verwendung. Das Ausgabeformat für eine Konvertierung von datetime- oder smalldatetime-Daten in Zeichendaten finden Sie in der vorherigen Tabelle.

⁵ Hijri ist ein Kalendersystem mit mehreren Variationen. SQL Server verwendet den kuwaitischen Algorithmus.

⁶ Bei einem Millisekundenwert (mmm) von 0 wird der Dezimalbruch des Millisekundenwerts nicht angezeigt. Der Wert 2022-11-07T18:26:20.000 wird beispielsweise als 2022-11-07T18:26:20 angezeigt.

⁷ In diesem Format entspricht mon dem vollständigen Monatsnamen in Form einer Hijri-Unicode-Darstellung mit mehreren Token. In einer US-Standardinstallation von SSMS wird dieser Wert nicht ordnungsgemäß gerendert.

⁸ Wird nur bei der CAST-Umwandlung von Zeichendaten in datetime- oder smalldatetime-Werte unterstützt. Wenn Zeichendaten, die nur Zeit- oder nur Datumskomponenten darstellen, in die Datentypen datetime oder smalldatetime umgewandelt werden, wird die nicht angegebene Zeitkomponente auf 00:00:00.000 festgelegt und die nicht angegebene Datumskomponente auf 1900-01-01.

⁹ Verwenden Sie den optionalen Zeitzonenindikator Z, um die Zuordnung von XML-datetime-Werten mit Zeitzoneninformationen zu SQL Server-datetime-Werten ohne Zeitzone zu vereinfachen. Z steht für die Zeitzone UTC-0. Andere Zeitzonen werden durch einen HH:MM-Offset in +- oder --Richtung angegeben. Beispiel: 2022-12-12T23:45:12-08:00.

Bei der Konvertierung von smalldatetime-Daten in Zeichendaten werden bei Formaten mit Sekunden oder Millisekunden an diesen Stellen Nullen ausgegeben. Sie können bei der Konvertierung von datetime- oder smalldatetime-Werten in einen char- oder varchar-Datentyp eine entsprechende Länge angeben, damit unerwünschte Teile in Datumsangaben abgeschnitten werden.

Bei der Konvertierung von Zeichendaten in datetimeoffset wird unter Verwendung eines Formats mit einer Zeitangabe ein Zeitzonenoffset an das Ergebnis angehängt.

float- und real-Formate

Wenn expressionfloat oder real ist, kann style einen der in der folgenden Tabelle aufgelisteten Werte aufweisen. Andere Werte werden als 0 verarbeitet.

money- und smallmoney-Formate

Wenn expressionmoney oder smallmoney ist, kann style einen der in der folgenden Tabelle aufgelisteten Werte aufweisen. Andere Werte werden als 0 verarbeitet.

xml-Formate

Wenn expressionxml ist, kann style einen der in der folgenden Tabelle aufgelisteten Werte aufweisen. Andere Werte werden als 0 verarbeitet.

Binäre Formate

Wenn expressionbinary(n), char(n), varbinary(n) oder varchar(n) ist, kann style einen der in der folgenden Tabelle aufgelisteten Werte aufweisen. Bei Formatwerten, die nicht in der Tabelle aufgelistet sind, wird ein Fehler zurückgegeben.

Implizite Konvertierungen

Bei impliziten Konvertierungen ist keine Spezifikation der CAST- oder CONVERT-Funktion erforderlich. Bei expliziten Konvertierungen ist eine Spezifikation der CAST- oder CONVERT-Funktion erforderlich. In der folgenden Abbildung werden alle expliziten und impliziten Datentypkonvertierungen aufgeführt, die für die vom SQL Server-System bereitgestellten Datentypen zulässig sind. Dazu gehören bigint, sql_variant und xml. Es gibt keine implizite Konvertierung bei der Zuweisung vom sql_variant-Datentyp, eine implizite Konvertierung zum sql_variant-Datentyp findet jedoch statt.

Das Diagramm oben veranschaulicht zwar alle expliziten und impliziten Konvertierungen, die in SQL Server zulässig sind. Der sich ergebende Datentyp der Konvertierung ist jedoch von dem ausgeführten Vorgang abhängig:

• Bei expliziten Konvertierungen bestimmt die Anweisung selbst den sich ergebenden Datentyp.
• Bei impliziten Konvertierungen führen Zuweisungsanweisungen wie das Festlegen des Werts einer Variablen oder das Einfügen eines Werts in eine Spalte zu dem Datentyp, der durch die Variablendeklaration oder Spaltendefinition festgelegt wurde.
• Bei Vergleichsoperatoren oder anderen Ausdrücken hängt der sich ergebende Datentyp von den Regeln der Datentyprangfolge ab.

Beim Konvertieren zwischen datetimeoffset und den Zeichentypen char, nchar, nvarchar und varchar sollte der konvertierte Zeitzonenoffset-Teil sowohl für HH als auch für MM stets zwei Stellen umfassen. Beispielsweise -08:00.

Da Unicode-Daten immer eine gerade Anzahl von Bytes verwenden, muss das Konvertieren von binary- oder varbinary-Datentypen in oder von Unicode-Datentypen vorsichtig erfolgen. Die folgende Konvertierung gibt beispielsweise nicht den Hexadezimalwert41 zurück. Sie gibt den Hexadezimalwert4100 zurück:

SELECT CAST(CAST(0x41 AS nvarchar) AS varbinary);

Weitere Informationen finden Sie unter Collation and Unicode Support.

Datentypen mit umfangreichen Werten

Datentypen mit hohen Werten weisen das gleiche implizite und explizite Konvertierungsverhalten auf wie ihre Entsprechungen mit kleineren Werten, insbesondere die Datentypen nvarchar, varbinary und varchar. Beachten Sie jedoch folgende Richtlinien:

• Die Konvertierung von image in varbinary(max) und umgekehrt stellt ebenso wie zwischen text und varchar(max) sowie ntext und nvarchar(max) eine implizite Konvertierung dar.
• Die Konvertierung von Datentypen mit hohen Werten, z.B. varchar(max) , in einen entsprechenden kleineren Datentyp, z.B. varchar, ist zwar eine implizite Konvertierung, doch kommt es zu einer Abschneidung, wenn die Größe des hohen Werts die angegebene Länge des kleineren Datentyps überschreitet.
• Die Konvertierung von nvarchar, varbinary oder varchar in einen entsprechenden kleineren Datentyp erfolgt implizit.
• Die Konvertierung vom sql_variant-Datentyp in einen Datentyp mit hohen Werten ist eine explizite Konvertierung.
• Datentypen mit hohen Werten können nicht in den sql_variant-Datentyp konvertiert werden.

Weitere Informationen zum Konvertieren des xml-Datentyps finden Sie unter Erstellen von Instanzen der XML-Daten.

xml-Datentyp

Wenn Sie den xml-Datentyp explizit oder implizit in einen Zeichenfolgen- oder Binärdatentyp umwandeln, wird der Inhalt des xml-Datentyps nach einer definierten Reihe von Regeln serialisiert. Informationen zu diesen Regeln finden Sie unter Definieren der Serialisierung von XML-Daten. Weitere Informationen zum Konvertieren anderer Datentypen in den xml-Datentyp finden Sie unter Erstellen von Instanzen der XML-Daten.

text- und image-Datentyp

Die automatische Datentypkonvertierung wird für die Datentypen text und image nicht unterstützt. Die explizite Konvertierung von text-Daten in Zeichendaten und von image- in binary- oder varbinary-Daten ist zwar möglich, doch nur bis zu einer maximalen Länge von 8000 Bytes. Falls Sie versuchen, eine unzulässige Konvertierung vorzunehmen, wie z.B. die Konvertierung eines Zeichenausdrucks mit Buchstaben in int-Daten, gibt SQL Server eine Fehlermeldung zurück.

Ausgabesortierung

Wenn die CAST- oder die CONVERT-Funktionen eine Zeichenfolge ausgeben und eine Zeichenfolgeneingabe empfangen, hat die Ausgabe dieselbe Sortierung und Sortierungsbezeichnung wie die Eingabe. Wenn die Eingabe keine Zeichenfolge ist, hat die Ausgabe die Standardsortierung der Datenbank und die Sortierungsbezeichnung „coercible-default“ (Standard erzwingbar). Weitere Informationen finden Sie unter Rangfolge der Sortierungen (Transact-SQL).

Wenn Sie der Ausgabe eine andere Sortierung zuweisen möchten, wenden Sie die COLLATE-Klausel auf den Ergebnisausdruck der CAST- oder CONVERT-Funktion an. Beispiel:

SELECT CAST('abc' AS varchar(5)) COLLATE French_CS_AS;

Abschneiden und Runden von Ergebnissen

Beim Konvertieren von Zeichen- oder Binärdatenausdrücken (binary, char, nchar, nvarchar, varbinary oder varchar) in einen Ausdruck eines anderen Datentyps könnten bei der Konvertierung die Ausgabedaten abgeschnitten oder nur teilweise angezeigt werden, oder es könnte ein Fehler zurückgegeben werden. Dies geschieht, wenn das Ergebnis zu kurz ist, um angezeigt zu werden. Konvertierungen in binary, char, nchar, nvarchar, varbinary oder varchar werden abgeschnitten, mit Ausnahme der in der folgenden Tabelle aufgelisteten Konvertierungen.

¹ Es wird ein Fehler zurückgegeben, da die Ergebnislänge zu kurz ist, um angezeigt zu werden.

In SQL Server wird sichergestellt, dass nur reversible Konvertierungen (d.h. Konvertierungen, bei denen konvertierte Datentypen in den ursprünglichen Datentyp zurückkonvertiert werden können) von Version zu Version die gleichen Ergebnisse erzielen. Im folgenden Beispiel wird eine solche Hin- und Rückkonvertierung veranschaulicht:

DECLARE @myval DECIMAL(5, 2);SET @myval = 193.57;SELECT CAST(CAST(@myval AS VARBINARY(20)) AS DECIMAL(10, 5));-- Or, using CONVERTSELECT CONVERT(DECIMAL(10, 5), CONVERT(VARBINARY(20), @myval));GO

Im folgenden Beispiel ist der resultierende Ausdruck zu klein, um angezeigt zu werden.

USE AdventureWorks2019;GOSELECT p.FirstName, p.LastName, SUBSTRING(p.Title, 1, 25) AS Title, CAST(e.SickLeaveHours AS CHAR(1)) AS [Sick Leave]FROM HumanResources.Employee eINNER JOIN Person.Person p ON e.BusinessEntityID = p.BusinessEntityIDWHERE NOT e.BusinessEntityID > 5;GO

Hier ist das Resultset.

FirstName LastName Title Sick Leave--------- ------------- ------- --------`Ken Sanchez NULL *Terri Duffy NULL *Roberto Tamburello NULL *Rob Walters NULL *Gail Erickson Ms. *(5 row(s) affected)

Beim Konvertieren von Datentypen mit unterschiedlichen Dezimalstellen gibt SQL Server manchmal einen abgeschnittenen oder einen gerundeten Ergebniswert zurück. In dieser Tabelle wird das Verhaltensmuster veranschaulicht.

¹ Die Konvertierung der float-Werte, die eine wissenschaftliche Schreibweise für decimal oder numeric verwenden, ist auf Werte mit einer Genauigkeit von 17Stellen beschränkt. Alle Werte mit einer Genauigkeit von mehr als 17 Stellen werden auf Null gerundet.

Die Werte 10.6496 und -10.6496 können z.B. während der Konvertierung in int- oder numeric-Types abgeschnitten oder gerundet werden:

SELECT CAST(10.6496 AS INT) AS trunc1, CAST(-10.6496 AS INT) AS trunc2, CAST(10.6496 AS NUMERIC) AS round1, CAST(-10.6496 AS NUMERIC) AS round2;

Die Ergebnisse der Abfrage sind in der folgenden Tabelle aufgeführt:

Falls eine Konvertierung von Datentypen vorgenommen wird, bei der der Zieldatentyp weniger Dezimalstellen aufweist als der Quelldatentyp, wird der Wert gerundet. Bei dieser Konvertierung wird beispielsweise $10.3497 zurückgegeben:

SELECT CAST(10.3496847 AS money);

SQL Server gibt eine Fehlermeldung zurück, wenn die nicht numerischen Daten char, nchar, varchar oder nvarchar in die Typen decimal, float, int oder numeric konvertiert werden. SQL Server gibt außerdem einen Fehler zurück, wenn eine leere Zeichenfolge (" ") in numeric oder decimal konvertiert wird.

Bestimmte datetime-Konvertierungen sind nicht deterministisch

Dies sind die Formate, bei denen die Konvertierung von „string“ in „datetime“ nicht deterministisch ist:

• Alle Formate unter 100¹
• 106
• 107
• 109
• 113
• 130

¹ Mit Ausnahme der Formate 20 und 21

Weitere Informationen finden Sie unter Nicht deterministische Konvertierung von Datumsliteralzeichenfolgen in DATE-Werte.

Ergänzende Zeichen (Ersatzpaare)

Wenn Sie in Versionen ab SQLServer2012 (11.x) Sortierungen ergänzender Zeichen verwenden, wird ein CAST-Vorgang von nchar oder nvarchar zu einem nchar- oder nvarchar-Typ von geringerer Länge in einem Ersatzzeichenpaar nicht abgeschnitten. Stattdessen wird er vor dem ergänzenden Zeichen abgeschnitten. Im folgenden Codefragment wird @x z.B. weggelassen, sodass nur 'ab' erhalten bleibt. Es ist nicht genügend Platz für das ergänzende Zeichen vorhanden.

DECLARE @x NVARCHAR(10) = 'ab' + NCHAR(0x10000);SELECT CAST(@x AS NVARCHAR(3));

Bei SC-Sortierungen entspricht das Verhalten von CONVERT dem von CAST. Weitere Informationen finden Sie im Abschnitt zu zusätzlichen Zeichen im Artikel Unicode-Unterstützung und Unterstützung von Sortierungen.

Kompatibilitätsunterstützung

In früheren Versionen von SQLServer ist das Standardformat für CAST- und CONVERT-Vorgänge bei den Datentypen time und datetime2 121, sofern keiner der Typen im Ausdruck einer berechneten Spalte verwendet wird. Für berechnete Spalten ist das Standardformat 0. Dieses Verhalten wirkt sich auf berechnete Spalten aus, wenn sie erstellt werden und in Abfragen mit automatischer Parametrisierung oder in Einschränkungsdefinitionen verwendet werden.

Bei einem Kompatibilitätsgrad von 110 und höher ist das Standardformat für CAST- und CONVERT-Vorgänge im Fall der Datentypen time und datetime2 immer 121. Basiert die Abfrage auf dem alten Verhalten, verwenden Sie einen Kompatibilitätsgrad unter 110, oder geben Sie in der betroffenen Abfrage explizit das Format 0 an.

¹ Gilt nicht für berechnete Spalten

Ein Upgrade der Datenbank auf den Kompatibilitätsgrad110 und höher ändert keine Benutzerdaten, die auf dem Datenträger gespeichert wurden. Sie müssen diese Daten entsprechend manuell korrigieren. Haben Sie beispielsweise SELECT INFO zum Erstellen einer Tabelle von einer Quelle verwendet, die einen Ausdruck für eine berechnete Spalte (oben beschrieben) beinhaltet, werden die Daten mit dem Format 0 anstelle der Definition der berechneten Spalte an sich gespeichert. Sie müssen diese Daten manuell aktualisieren, um sie an das Format 121 anzupassen.

Beispiele

A. Verwenden von CAST und CONVERT

In diesen Beispielen werden die Namen der Produkte abgerufen, deren Listenpreis mit der Ziffer 3 beginnt. Die ListPrice-Werte werden in int-Werte konvertiert.

Verwenden Sie CAST:

USE AdventureWorks2019;GOSELECT SUBSTRING(Name, 1, 30) AS ProductName, ListPriceFROM Production.ProductWHERE CAST(ListPrice AS INT) LIKE '33%';GO

Verwenden Sie CONVERT:

USE AdventureWorks2019;GOSELECT SUBSTRING(Name, 1, 30) AS ProductName, ListPriceFROM Production.ProductWHERE CONVERT(INT, ListPrice) LIKE '33%';GO

Hier ist das Resultset. Das Beispielresultset ist bei CAST und CONVERT identisch.

ProductName ListPrice------------------------------ ---------------------LL Road Frame - Black, 58 337.22LL Road Frame - Black, 60 337.22LL Road Frame - Black, 62 337.22LL Road Frame - Red, 44 337.22LL Road Frame - Red, 48 337.22LL Road Frame - Red, 52 337.22LL Road Frame - Red, 58 337.22LL Road Frame - Red, 60 337.22LL Road Frame - Red, 62 337.22LL Road Frame - Black, 44 337.22LL Road Frame - Black, 48 337.22LL Road Frame - Black, 52 337.22Mountain-100 Black, 38 3374.99Mountain-100 Black, 42 3374.99Mountain-100 Black, 44 3374.99Mountain-100 Black, 48 3374.99HL Road Front Wheel 330.06LL Touring Frame - Yellow, 62 333.42LL Touring Frame - Blue, 50 333.42LL Touring Frame - Blue, 54 333.42LL Touring Frame - Blue, 58 333.42LL Touring Frame - Blue, 62 333.42LL Touring Frame - Yellow, 44 333.42LL Touring Frame - Yellow, 50 333.42LL Touring Frame - Yellow, 54 333.42LL Touring Frame - Yellow, 58 333.42LL Touring Frame - Blue, 44 333.42HL Road Tire 32.60(28 rows affected)

B. Verwenden von CAST mit arithmetischen Operatoren

Im folgenden Beispiel wird eine einzelne Spalte (Computed) berechnet. Hierbei wird der Gesamtumsatz des laufenden Jahres (SalesYTD) durch den Prozentsatz der Umsatzbeteiligung (CommissionPCT) geteilt. Dieser Wert wird auf die nächste ganze Zahl gerundet und anschließend mithilfe von CAST in einen int-Datentyp konvertiert.

USE AdventureWorks2019;GOSELECT CAST(ROUND(SalesYTD / CommissionPCT, 0) AS INT) AS ComputedFROM Sales.SalesPersonWHERE CommissionPCT != 0;GO

Hier ist das Resultset.

Computed------379753754346698349257144242176493899281101272030187254921262375029894820225078411923924689010166422012451133697688107(14 row(s) affected)

C. Verwenden von CAST zur Verkettung

Im folgenden Beispiel werden nicht auf Zeichen basierende Ausdrücke mithilfe von CAST verkettet. Verwendet wird die Datenbank AdventureWorksDW2019.

SELECT 'The list price is ' + CAST(ListPrice AS VARCHAR(12)) AS ListPriceFROM dbo.DimProductWHERE ListPrice BETWEEN 350.00 AND 400.00;

Hier ist das Resultset.

ListPrice------------------------The list price is 357.06The list price is 364.09The list price is 364.09The list price is 364.09The list price is 364.09

D: Verwenden von CAST zur Generierung besser lesbaren Texts

Im folgenden Beispiel wird CAST in der SELECT-Liste verwendet, um die Name-Spalte in eine char(10)-Spalte zu konvertieren. Verwendet wird die Datenbank AdventureWorksDW2019.

SELECT DISTINCT CAST(EnglishProductName AS CHAR(10)) AS Name, ListPriceFROM dbo.DimProductWHERE EnglishProductName LIKE 'Long-Sleeve Logo Jersey, M';GO

Hier ist das Resultset.

Name ListPrice---------- ---------Long-Sleev 31.2437Long-Sleev 32.4935Long-Sleev 49.99

E. Verwenden von CAST mit der LIKE-Klausel

In diesem Beispiel werden die SalesYTD-Werte der Spalte money in den Datentyp int und anschließend in den Datentyp char(20) konvertiert, damit sie mit der LIKE-Klausel verwendet werden können.

USE AdventureWorks2019;GOSELECT p.FirstName, p.LastName, s.SalesYTD, s.BusinessEntityIDFROM Person.Person AS pINNER JOIN Sales.SalesPerson AS s ON p.BusinessEntityID = s.BusinessEntityIDWHERE CAST(CAST(s.SalesYTD AS INT) AS CHAR(20)) LIKE '2%';GO

Hier ist das Resultset.

FirstName LastName SalesYTD BusinessEntityID---------------- ------------------- ---------------- -------------Tsvi Reiter 2811012.7151 279Syed Abbas 219088.8836 288Rachel Valdez 2241204.0424 289(3 row(s) affected)

F. Verwenden von CONVERT oder CAST mit typisierten XML-Daten

In den folgenden Beispielen wird die Konvertierung in typisierte XML-Daten mithilfe von CONVERT und mit XML-Datentyp und -Spalten (SQL Server) dargestellt.

In diesem Beispiel wird eine aus Leerzeichen, Text und Markup bestehende Zeichenfolge in typisierte XML-Daten konvertiert und alle bedeutungslosen Leerzeichen (begrenzender Leerraum zwischen Knoten) entfernt:

SELECT CONVERT(XML, '<root><child/></root>')

In diesem Beispiel wird eine ähnliche, aus Leerzeichen, Text und Markup bestehende Zeichenfolge in typisierte XML-Daten konvertiert und alle bedeutungslosen Leerzeichen (begrenzender Leerraum zwischen Knoten) beibehalten.

SELECT CONVERT(XML, '<root> <child/> </root>', 1)

In diesem Beispiel wird eine aus Leerzeichen, Text und Markup bestehende Zeichenfolge in typisierte XML-Daten umgewandelt:

SELECT CAST('<Name><FName>Carol</FName><LName>Elliot</LName></Name>' AS XML)

Weitere Beispiele finden Sie unter Erstellen von Instanzen der XML-Daten.

G. Verwenden von CAST und CONVERT mit datetime-Daten

Im folgenden Beispiel werden zuerst GETDATE()-Werte verwendet, um das aktuelle Datum und die aktuelle Uhrzeit darzustellen. CAST wird verwendet, um das aktuelle Datum und die aktuelle Uhrzeit in einen Zeichendatentyp zu ändern. Anschließend wird CONVERT verwendet, um das Datum und die Uhrzeit im ISO 8601-Format anzuzeigen.

SELECT GETDATE() AS UnconvertedDateTime, CAST(GETDATE() AS NVARCHAR(30)) AS UsingCast, CONVERT(NVARCHAR(30), GETDATE(), 126) AS UsingConvertTo_ISO8601;GO

Hier ist das Resultset.

UnconvertedDateTime UsingCast UsingConvertTo_ISO8601----------------------- ---------------------- ------------------------------2022-04-18 09:58:04.570 Apr 18 2022 9:58AM 2022-04-18T09:58:04.570(1 row(s) affected)

Das folgende Beispiel entspricht in etwa der Umkehrung des vorherigen Beispiels. In diesem Beispiel werden ein Datum und eine Uhrzeit als Zeichendaten angezeigt. CAST wird verwendet, um die Zeichendaten in datetime-Datentypen zu ändern. Anschließend wird CONVERT verwendet, um die Zeichendaten in den datetime-Datentyp zu ändern.

SELECT '2006-04-25T15:50:59.997' AS UnconvertedText, CAST('2006-04-25T15:50:59.997' AS DATETIME) AS UsingCast, CONVERT(DATETIME, '2006-04-25T15:50:59.997', 126) AS UsingConvertFrom_ISO8601;GO

Hier ist das Resultset.

UnconvertedText UsingCast UsingConvertFrom_ISO8601----------------------- ----------------------- ------------------------2006-04-25T15:50:59.997 2006-04-25 15:50:59.997 2006-04-25 15:50:59.997(1 row(s) affected)

H. Verwenden von CONVERT mit Binär- und Zeichendaten

Die folgenden Beispiele zeigen die Ergebnisse der Konvertierung von Binär- und Zeichendaten mit verschiedenen Formaten.

--Convert the binary value 0x4E616d65 to a character value.SELECT CONVERT(CHAR(8), 0x4E616d65, 0) AS [Style 0, binary to character];

Hier ist das Resultset.

Style 0, binary to character----------------------------Name(1 row(s) affected)

Dieses Beispiel zeigt, wie Format 1 das Abschneiden von Ergebnissen erzwingen kann. Die Zeichen 0x im Ergebnis erzwingen das Abschneiden.

SELECT CONVERT(CHAR(8), 0x4E616d65, 1) AS [Style 1, binary to character];

Hier ist das Resultset.

Style 1, binary to character------------------------------0x4E616D(1 row(s) affected)

Das folgende Beispiel zeigt, dass Format2 das Ergebnis nicht abschneidet, da die Zeichen 0x nicht im Ergebnis enthalten sind.

SELECT CONVERT(CHAR(8), 0x4E616d65, 2) AS [Style 2, binary to character];

Hier ist das Resultset.

Style 2, binary to character------------------------------4E616D65(1 row(s) affected)

Konvertieren Sie den Zeichenwert 'Name' in einen Binärwert.

SELECT CONVERT(BINARY(8), 'Name', 0) AS [Style 0, character to binary];

Hier ist das Resultset.

Style 0, character to binary----------------------------0x4E616D6500000000(1 row(s) affected)

SELECT CONVERT(BINARY(4), '0x4E616D65', 1) AS [Style 1, character to binary];

Hier ist das Resultset.

Style 1, character to binary----------------------------0x4E616D65(1 row(s) affected)

SELECT CONVERT(BINARY(4), '4E616D65', 2) AS [Style 2, character to binary];

Hier ist das Resultset.

Style 2, character to binary----------------------------------0x4E616D65(1 row(s) affected)

I. Konvertieren von date- und time-Datentypen

Das folgende Beispiel zeigt die Konvertierung von date-, time- und datetime-Datentypen.

DECLARE @d1 DATE, @t1 TIME, @dt1 DATETIME;SET @d1 = GETDATE();SET @t1 = GETDATE();SET @dt1 = GETDATE();SET @d1 = GETDATE();-- When converting date to datetime the minutes portion becomes zero.SELECT @d1 AS [DATE], CAST(@d1 AS DATETIME) AS [date as datetime];-- When converting time to datetime the date portion becomes zero-- which converts to January 1, 1900.SELECT @t1 AS [TIME], CAST(@t1 AS DATETIME) AS [time as datetime];-- When converting datetime to date or time non-applicable portion is dropped.SELECT @dt1 AS [DATETIME], CAST(@dt1 AS DATE) AS [datetime as date], CAST(@dt1 AS TIME) AS [datetime as time];

Stellen Sie sicher, dass die Werte innerhalb eines kompatiblen Bereichs liegen, wenn Sie eine Konvertierung von date in datetime oder datetime2 in Betracht ziehen. Der minimale Jahreswert für datetime ist 1753, während der minimale Jahreswert für date und datetime20001 beträgt.

DECLARE @d1 DATE, @dt1 DATETIME , @dt2 DATETIME2SET @d1 = '1492-08-03'--This is okay; Minimum YYYY for DATE is 0001SET @dt2 = CAST(@d1 AS DATETIME2)--This is okay; Minimum YYYY for DATETIME2 IS 0001SET @dt1 = CAST(@d1 AS DATETIME)--This will error with (Msg 242) "The conversion of a date data type to a datetime data type resulted in an out-of-range value."--Minimum YYYY for DATETIME is 1753

J. Verwenden von CONVERT mit datetime-Daten in unterschiedlichen Formaten

Im folgenden Beispiel werden zuerst GETDATE()-Werte verwendet. CONVERT wird verwendet, um alle Datums- und Uhrzeitformate anzuzeigen, die sich im Abschnitt Datums- und Uhrzeitformate dieses Artikels befinden.

K. Auswirkungen der Datentyprangfolge in zulässigen Konvertierungen

Im folgenden Beispiel wird eine Variable des Typs varchar(10) definiert. Dieser wird dann ein Integerwert zugewiesen. Anschließend wird eine SELECT-Anweisung für die Verkettung der Variablen mit einer Zeichenfolge ausgeführt.

DECLARE @string VARCHAR(10);SET @string = 1;SELECT @string + ' is a string.' AS Result

Hier ist das Resultset.

Result-----------------------1 is a string.

Der int-Wert1 wurde in den Typ varchar konvertiert.

Im folgenden Beispiel wird eine ähnliche Abfrage gezeigt, in der jedoch eine int-Variable verwendet wird:

DECLARE @notastring INT;SET @notastring = '1';SELECT @notastring + ' is not a string.' AS Result

In diesem Fall löst die SELECT-Anweisung den folgenden Fehler aus:

Msg 245, Level 16, State 1, Line 3Conversion failed when converting the varchar value ' is not a string.' to data type int.

Zur Auswertung des Ausdrucks @notastring + ' is not a string.' gilt Folgendes: SQL Server muss den Regeln der Datentyprangfolge folgen, um die implizite Konvertierung abzuschließen, bevor das Ergebnis des Ausdrucks berechnet werden kann. Da int eine höhere Rangfolge als varchar hat, versucht SQLServer, die Zeichenfolge in eine ganze Zahl zu konvertieren. Dieser Vorgang schlägt fehl, da diese Zeichenfolge nicht in eine ganze Zahl konvertiert werden kann.

Wenn eine konvertierbare Zeichenfolge angegeben wird, wird die Anweisung wie im folgenden Beispiel erfolgreich ausgeführt:

DECLARE @notastring INT;SET @notastring = '1';SELECT @notastring + '1'

In diesem Fall kann die Zeichenfolge '1' in den Integerwert 1 konvertiert werden, sodass die SELECT-Anweisung den Wert 2 zurückgibt. Wenn die angegebenen Datentypen Integerwerte sind, führt der Operator+ nicht zu einer Zeichenfolgenverkettung, sondern zu einer mathematischen Addition.

Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

L. Verwenden von CAST und CONVERT

In diesem Beispiele werden die Namen der Produkte abgerufen, deren Listenpreis mit der Ziffer 3 beginnt. Der ListPrice-Wert dieser Produkte wird in einen int-Wert konvertiert. Verwendet wird die Datenbank AdventureWorksDW2019.

SELECT EnglishProductName AS ProductName, ListPriceFROM dbo.DimProductWHERE CAST(ListPrice AS int) LIKE '3%';

Dieses Beispiel zeigt dieselbe Abfrage mit CONVERT anstatt CAST. Verwendet wird die Datenbank AdventureWorksDW2019.

SELECT EnglishProductName AS ProductName, ListPriceFROM dbo.DimProductWHERE CONVERT(INT, ListPrice) LIKE '3%';

M. Verwenden von CAST mit arithmetischen Operatoren

Im folgenden Beispiel wird eine einzelne Spalte berechnet. Hierbei wird der Einzelpreis des Produkts (UnitPrice) durch den Prozentsatz für den Abzug (UnitPriceDiscountPct) geteilt. Dieses Ergebnis wird in einen int-Datentyp konvertiert, nachdem es auf die nächste ganze Zahl gerundet wurde. In diesem Beispiel wird die AdventureWorksDW2019-Datenbank verwendet.

SELECT ProductKey, UnitPrice,UnitPriceDiscountPct, CAST(ROUND (UnitPrice*UnitPriceDiscountPct,0) AS int) AS DiscountPriceFROM dbo.FactResellerSalesWHERE SalesOrderNumber = 'SO47355' AND UnitPriceDiscountPct > .02;

Hier ist das Resultset.

ProductKey UnitPrice UnitPriceDiscountPct DiscountPrice---------- --------- -------------------- -------------323 430.6445 0.05 22213 18.5043 0.05 1456 37.4950 0.10 4456 37.4950 0.10 4216 18.5043 0.05 1

N. Verwenden von CAST mit der LIKE-Klausel

Im folgenden Beispiel wird die Spalte moneyListPrice in eine Spalte des Typs int und anschließend in eine Spalte des Typs char(20) umgewandelt, damit sie mit der LIKE-Klausel verwendet werden kann. In diesem Beispiel wird die AdventureWorksDW2019-Datenbank verwendet.

SELECT EnglishProductName AS Name, ListPriceFROM dbo.DimProductWHERE CAST(CAST(ListPrice AS INT) AS CHAR(20)) LIKE '2%';

O. Verwenden von CAST und CONVERT mit datetime-Daten

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit dargestellt. CAST wird verwendet, um das aktuelle Datum und die aktuelle Uhrzeit in einen Zeichendatentyp zu ändern. Anschließend werden das Datum und die Uhrzeit mithilfe von CONVERT im ISO8601-Format angezeigt. In diesem Beispiel wird die AdventureWorksDW2019-Datenbank verwendet.

SELECT TOP(1) SYSDATETIME() AS UnconvertedDateTime, CAST(SYSDATETIME() AS NVARCHAR(30)) AS UsingCast, CONVERT(NVARCHAR(30), SYSDATETIME(), 126) AS UsingConvertTo_ISO8601FROM dbo.DimCustomer;

Hier ist das Resultset.

UnconvertedDateTime UsingCast UsingConvertTo_ISO8601--------------------- --------------------------- ---------------------------07/20/2010 1:44:31 PM 2010-07-20 13:44:31.5879025 2010-07-20T13:44:31.5879025

Das folgende Beispiel entspricht in etwa der Umkehrung des vorherigen Beispiels. In diesem Beispiel werden ein Datum und eine Uhrzeit als Zeichendaten angezeigt. CAST wird verwendet, um die Zeichendaten in datetime-Datentypen zu ändern. Anschließend wird CONVERT verwendet, um die Zeichendaten in den datetime-Datentyp zu ändern. In diesem Beispiel wird die AdventureWorksDW2019-Datenbank verwendet.

SELECT TOP(1) '2010-07-25T13:50:38.544' AS UnconvertedText,CAST('2010-07-25T13:50:38.544' AS DATETIME) AS UsingCast, CONVERT(DATETIME, '2010-07-25T13:50:38.544', 126) AS UsingConvertFrom_ISO8601FROM dbo.DimCustomer;

Hier ist das Resultset.

UnconvertedText UsingCast UsingConvertFrom_ISO8601----------------------- ----------------------- ------------------------2010-07-25T13:50:38.544 07/25/2010 1:50:38 PM 07/25/2010 1:50:38 PM

Weitere Informationen

• FORMAT (Transact-SQL)
• STR (Transact-SQL)
• SELECT (Transact-SQL)
• Systemfunktionen (Transact-SQL)
• Collation and Unicode Support

Nächste Schritte

• Rangfolge der Datentypen (Transact-SQL)
• Datentypkonvertierung (Datenbank-Engine)
• Schreiben internationaler Transact-SQL-Anweisungen