CAST und CONVERT (Transact-SQL)

Wenn expression ein Datums- oder Zeitdatentyp ist, kann style einer der in der folgenden Tabelle aufgelisteten Werte sein. Andere Werte werden als 0 verarbeitet. SQL Server unterstützt das arabische Datumsformat mithilfe des kuwaitischen Algorithmus.

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

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

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

4 Vorgesehen für XML-Verwendung. Für eine Konvertierung aus datetime- oder smalldatetime-Daten in Zeichendaten ist das Ausgabeformat so wie in der Tabelle beschrieben.

5 Hijri ist ein Kalendersystem mit verschiedenen Varianten. In SQL Server wird der Kuwaiti-Algorithmus verwendet.

Wichtig

Standardmäßig verwendet SQL Server bei der Interpretation von zweistelligen Jahresangaben 2049 als Umstellungsjahr. Das zweistellige Jahr 49 wird also als 2049 und das zweistellige Jahr 50 als 1950 interpretiert. Viele Clientanwendungen, z. B. auf OLE-Automatisierungsobjekten basierende Anwendungen, ziehen die Grenze bei 2030. SQL Server stellt die Konfigurationsoption two digit year cutoff bereit, mit der die von SQL Server verwendete Einstellung geändert werden kann, um eine einheitliche Behandlung der Datumsangaben zu erzielen. Die Verwendung von vierstelligen Jahresangaben wird empfohlen.

6 Wird nur bei der Umwandlung mit CAST 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.

7 Der optionale Zeitzonenindikator Z vereinfacht die Zuordnung von XML-datetime-Werten mit Zeitzoneninformationen zu datetime-Werten ohne Zeitzone in SQL Server. Z ist der Indikator für die Zeitzone UTC-0. Andere Zeitzonen werden durch einen positiven (+) oder negativen (-) Offset (HH:MM) angegeben. Beispiel: 2006-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 unerwünschte Teile in Datumsangaben abschneiden, indem Sie bei der Konvertierung von Werten der Datentypen datetime oder smalldatetime in einen char- oder varchar-Datentyp eine entsprechende Länge angeben.

Bei der Konvertierung in datetimeoffset von Zeichendaten mit einem Zeitformat wird dem Ergebnis ein Zeitzonenoffset angehängt.

Wenn expression den Datentyp float oder real aufweist, kann style einer der Werte in der folgenden Tabelle sein. Andere Werte werden als 0 verarbeitet.

Wenn expression den Datentyp money oder smallmoney aufweist, kann style einer der Werte in der folgenden Tabelle sein. Andere Werte werden als 0 verarbeitet.

Wenn expressionxml ist, kann style einer der Werte in der folgenden Tabelle sein. Andere Werte werden als 0 verarbeitet.

Wert	Ausgabe
0 (Standardwert)	Verwenden Sie das Standardanalyseverhalten, bei dem bedeutungslose Leerzeichen verworfen werden und interne DTD-Teilmengen nicht zulässig sind. Hinweis Beim Konvertieren in den xml-Datentyp werden bedeutungslose Leerzeichen aus SQL Server anders behandelt als in XML 1.0. Weitere Informationen finden Sie unter Generieren von XML-Instanzen.
1	Bedeutungslose Leerzeichen erhalten. Mit dieser Formateinstellung wird festgelegt, dass die Standardbehandlung xml:space sich so verhält, als wäre stattdessen xml:space="preserve" angegeben worden.
2	Begrenzte interne DTD-Teilmengenverarbeitung aktivieren. Bei aktivierter interner Teilmengenverarbeitung kann der Server die folgenden Informationen, die in einer internen DTD-Teilmenge bereitgestellt werden, zur Ausführung von Analysevorgängen ohne Überprüfungscharakter verwenden. Für Attribute werden die Standardwerte angewendet. Interne Entitätsverweise werden aufgelöst und erweitert. Das DTD-Inhaltsmodell wird auf seine syntaktische Richtigkeit geprüft. Der Parser ignoriert externe DTD-Teilmengen. Er nimmt auch keine Auswertung der XML-Deklaration vor, um festzustellen, ob das standalone-Attribut auf yes oder no festgelegt ist. Stattdessen wird die XML-Instanz wie ein eigenständiges Dokument analysiert.
3	Bedeutungslose Leerzeichen erhalten und die begrenzte interne DTD-Teilmengenverarbeitung aktivieren.

Wenn expression den Datentyp binary(n), varbinary(n), char(n) oder varchar(n) aufweist, kann style einer der Werte in der folgenden Tabelle sein. Bei Formatwerten, die nicht in der Tabelle aufgelistet sind, wird ein Fehler zurückgegeben.

Implizite Konvertierungen sind Konvertierungen, die ohne Angabe der CAST- oder CONVERT-Funktion durchgeführt werden. Explizite Konvertierungen sind Konvertierungen, die die Angabe der CAST- oder CONVERT-Funktion erfordern. 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. Zu diesen gehören xml, bigint und sql_variant. Es gibt keine implizite Konvertierung bei der Zuweisung vom sql_variant-Datentyp, eine implizite Konvertierung zum sql_variant-Datentyp findet jedoch statt.

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

Hinweis
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 z. B. nicht den Hexadezimalwert 41, sondern 4100 zurück: SELECT CAST(CAST(0x41 AS nvarchar) AS varbinary).

Datentypen mit umfangreichen Werten weisen das gleiche implizite und explizite Konvertierungsverhalten auf wie ihre kleineren Gegenstücke, insbesondere die Datentypen varchar, nvarchar und varbinary. Sie sollten jedoch die folgenden Richtlinien beachten:

• Die Konvertierung von image in varbinary(max) und umgekehrt ist eine implizite Konvertierung. Das Gleiche gilt für Konvertierungen zwischen text und varchar(max) sowie zwischen ntext und nvarchar(max).

• 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 der umfangreiche Wert sich als zu groß für die angegebene Länge des kleineren Datentyps erweist.

• Die Konvertierung von varchar, nvarchar oder varbinary in den jeweils entsprechenden Datentyp mit umfangreichen Werten wird implizit ausgeführt.

• Die Konvertierung vom sql_variant-Datentyp in einen Datentyp mit umfangreichen Werten ist eine explizite Konvertierung.

• Datentypen mit umfangreichen Werten können nicht in den sql_variant-Datentyp konvertiert werden.

Informationen zum Konvertieren der benutzerdefinierten CLR (Common Language Runtime)-Typen von Microsoft.NET Framework finden Sie unter Ausführen von Operationen an benutzerdefinierten Typen. Weitere Informationen zum Konvertieren des xml-Datentyps finden Sie unter Generieren von XML-Instanzen.

Wenn Sie den xml-Datentyp explizit oder implizit in einen Zeichenfolgen- oder Binärdatentyp umwandeln, wird der Inhalt des xml-Datentyps nach einer Reihe von Regeln serialisiert. Informationen zu diesen Regeln finden Sie unter Serialisierung von XML-Daten. Informationen dazu, wie Sie XML- in CLR-benutzerdefinierte Datentypen umwandeln, finden Sie unter Ausführen von Operationen an benutzerdefinierten Typen. Informationen dazu, wie sich andere Datentypen in den xml-Datentyp konvertieren lassen, finden Sie unter Generieren von XML-Instanzen.

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.

Wenn sowohl die Ausgabe von CAST oder CONVERT als auch die Eingabe eine Zeichenfolge ist, 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 von 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

Werden Zeichenausdrücke oder binäre Ausdrücke (char, nchar, nvarchar, varchar, binary oder varbinary) in einen Ausdruck eines anderen Datentyps konvertiert, können die Daten abgeschnitten oder nur teilweise angezeigt werden, bzw. es wird ein Fehler zurückgegeben, da das Ergebnis zum Anzeigen zu kurz ist. Konvertierungen in char, varchar, nchar, nvarchar, binary und varbinary werden abgeschnitten, mit Ausnahme der in der folgenden Tabelle aufgelisteten Konvertierungen.

* = Die Ergebnislänge ist zu kurz, um angezeigt zu werden. E = 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 CONVERT
SELECT CONVERT(decimal(10,5), CONVERT(varbinary(20), @myval))

Hinweis
Versuchen Sie nicht, binary-Werte zu erstellen und diese dann in einen Datentyp der numerischen Datentypkategorie zu konvertieren. SQL Server kann nicht sicherstellen, dass das Ergebnis einer Konvertierung von einem decimal- oder numeric-Datentyp in binary zwischen verschiedenen Versionen von SQL Server gleich ausfallen wird.

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

USE AdventureWorks;
GO
SELECT c.FirstName, c.LastName, SUBSTRING(c.Title, 1, 25) AS Title, CAST(e.SickLeaveHours AS char(1)) AS 'Sick Leave'
FROM HumanResources.Employee e JOIN Person.Contact c ON e.EmployeeID = c. ContactID
WHERE NOT EmployeeID >5

Dies ist das Resultset.

FirstName LastName       Title                Sick Leave
-------------- -------------  --------------------  -----------
Gustavo        Achong         Mr.                   *
Catherine      Abel           Ms.                   *
Kim            Abercrombie    Ms.                   *
Humberto       Acevedo        Sr.                   *
Pilar          Ackerman       Sra.                  *

(5 row(s) affected)

Beim Konvertieren von Datentypen mit unterschiedlichen Dezimalstellen wird der Ergebniswert manchmal abgeschnitten und manchmal gerundet. In der folgenden Tabelle wird das Verhaltensmuster veranschaulicht.

Das Ergebnis der Konvertierung im folgenden Beispiel ist beispielsweise 10:

SELECT CAST(10.6496 AS int)

Falls eine Konvertierung von Datentypen vorgenommen wird, bei der der Zieldatentyp weniger Dezimalstellen hat als der Quelldatentyp, wird der Wert abgeschnitten. Das Ergebnis der Konvertierung im folgenden Beispiel ist $10.3497:

SELECT CAST(10.3496847 AS money)

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

Konvertierungen von string in datetime werden in SQL Server 2000 als deterministisch markiert. Dies gilt jedoch nicht für die in der folgenden Tabelle aufgelisteten Formate. Bei diesen Formaten hängen die Konvertierungen von den Spracheinstellungen ab. In SQL Server 2005 und neueren Versionen werden diese Konvertierungen als nicht deterministisch markiert.

In der folgenden Tabelle werden die Formate aufgelistet, bei denen die Konvertierung von String in datetime nicht deterministisch ist.

1 Mit Ausnahme der Formate 20 und 21

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

-- Use CAST
USE AdventureWorks;
GO
SELECT SUBSTRING(Name, 1, 30) AS ProductName, ListPrice
FROM Production.Product
WHERE CAST(ListPrice AS int) LIKE '3%';
GO

-- Use CONVERT.
USE AdventureWorks;
GO
SELECT SUBSTRING(Name, 1, 30) AS ProductName, ListPrice
FROM Production.Product
WHERE CONVERT(int, ListPrice) LIKE '3%';
GO

Im folgenden Beispiel wird eine einzelne Spalte (Computed) berechnet. Hierbei wird der aufgelaufene Jahresumsatz (SalesYTD) durch den Prozentsatz der Umsatzbeteiligung (CommissionPCT) geteilt. Dieses Ergebnis wird in einen int-Datentyp konvertiert, nachdem es auf die nächste ganze Zahl gerundet wurde.

USE AdventureWorks;
GO
SELECT CAST(ROUND(SalesYTD/CommissionPCT, 0) AS int) AS 'Computed'
FROM Sales.SalesPerson 
WHERE CommissionPCT != 0;
GO

Dies ist das Resultset.

Computed

------

379753754

346698349

257144242

176493899

281101272

0

301872549

212623750

298948202

250784119

239246890

101664220

124511336

97688107

(14 row(s) affected)

Im folgenden Beispiel werden nicht auf Zeichen basierende, nicht binäre Ausdrücke mithilfe von CAST verkettet.

USE AdventureWorks;
GO
SELECT 'The list price is ' + CAST(ListPrice AS varchar(12)) AS ListPrice
FROM Production.Product
WHERE ListPrice BETWEEN 350.00 AND 400.00;
GO

Dies ist das Resultset.

ListPrice

------------------

The list price is 357.06

The list price is 364.09

The list price is 364.09

The list price is 364.09

The list price is 364.09

(5 row(s) affected)

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

USE AdventureWorks;
GO
SELECT DISTINCT CAST(p.Name AS char(10)) AS Name, s.UnitPrice
FROM Sales.SalesOrderDetail s JOIN Production.Product p on s.ProductID = p.ProductID
WHERE Name LIKE 'Long-Sleeve Logo Jersey, M';
GO

Dies ist das Resultset.

Name       UnitPrice

---------- ---------------------

Long-Sleev 31.2437

Long-Sleev 32.4935

Long-Sleev 49.99

(3 row(s) affected)

Im folgenden Beispiel wird die money-Spalte SalesYTD in eine int-Spalte und anschließend in eine char(20)-Spalte konvertiert, sodass die mit der LIKE-Klausel verwendet werden kann.

USE AdventureWorks;
GO
SELECT p.FirstName, p.LastName, s.SalesYTD, s.SalesPersonID
FROM Person.Contact p JOIN Sales.SalesPerson s ON p.ContactID = s.SalesPersonID
WHERE CAST(CAST(s.SalesYTD AS int) AS char(20)) LIKE '2%';
GO

Dies ist das Resultset.

FirstName        LastName            SalesYTD         SalesPersonID

---------------- ------------------- ---------------- -------------

Carol             Elliott             2811012.7151     279

Julie             Estes               219088.8836      288

Janeth            Esteves             2241204.0424     289

(3 row(s) affected)

In den folgenden Beispielen wird die Konvertierung in typisierte XML-Daten mithilfe von CONVERT und mit dem XML-Datentyp dargestellt.

In diesem Beispiel wird eine aus Leerzeichen, Text und Markup bestehende Zeichenfolge in typisierte XML-Daten konvertiert und alle bedeutungslosen Leerzeichen (Leerzeichen an der Grenze zwischen Knoten) entfernt.

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 (Leerzeichen an der Grenze zwischen Knoten) beibehalten.

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

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

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

Weitere Beispiele finden Sie unter Generieren von XML-Instanzen.

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 wird CONVERT verwendet, um das Datum und die Uhrzeit im ISO 8901-Format anzuzeigen.

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

Dies ist das Resultset.

UnconvertedDateTime     UsingCast                      UsingConvertTo_ISO8601

----------------------- ------------------------------ ------------------------------

2006-04-18 09:58:04.570 Apr 18 2006 9:58AM            2006-04-18T09:58:04.570

(1 row(s) affected)

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

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

Dies 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)

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'

Dies ist das Resultset.

Style 0, binary to character

----------------------------

Name

(1 row(s) affected)

--The following example shows how Style 1 can force the result
--to be truncated. The truncation is caused by
--including the characters 0x in the result.
SELECT CONVERT(char(8), 0x4E616d65, 1) AS 'Style 1, binary to character'

Dies ist das Resultset.

Style 1, binary to character

------------------------------

0x4E616D

(1 row(s) affected)

--The following example shows that Style 2 does not truncate the
--result because the characters 0x are not included in
--the result.
SELECT CONVERT(char(8), 0x4E616d65, 2) AS 'Style 2, binary to character'

Dies ist das Resultset.

Style 2, binary to character

------------------------------

4E616D65

(1 row(s) affected)

--Convert the character value 'Name' to a binary value.
SELECT CONVERT(binary(8), 'Name', 0) AS 'Style 0, character to binary'

Dies 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'

Dies ist das Resultset.

Style 1, character to binary

----------------------------------

0x4E616D65

(1 row(s) affected)

SELECT CONVERT(binary(4), '4E616D65', 1) AS 'Style 2, character to binary'

Dies ist das Resultset.

Style 2, character to binary

----------------------------------

0x4E616D65

(1 row(s) affected)