datetimeoffset (Transact-SQL)

Definiert ein auf dem 24-Stunden-Format basierendes Datum, das mit einer Uhrzeit kombiniert ist, bei der die Zeitzone beachtet wird.

Beschreibung von datetimeoffset

Unterstützte Formate der Zeichenfolgenliterale für datetimeoffset

In der folgenden Tabelle werden die unterstützten ISO 8601-Zeichenfolgenliterale für datetimeoffset aufgelistet. Informationen zu alphabetischen, numerischen und unstrukturierten Formaten sowie zu Zeitformaten für die Datums- und Uhrzeitteile von datetimeoffset finden Sie unter date (Transact-SQL) und time (Transact-SQL).

Zeitzonenoffset

Ein Zeitzonenoffset gibt den Zonenoffset von der UTC-Zeit für einen time-Wert oder einen datetime-Wert. Der Zeitzonenoffset kann im Format [+|-] hh:mm dargestellt werden:

• Bei hh handelt es sich um zwei Ziffern im Bereich von 00 bis 14, die die Anzahl der Stunden im Zeitzonenoffset darstellen.

• Bei "mm" handelt es sich um zwei Ziffern im Bereich von 00 bis 59, die die Anzahl der zusätzlichen Minuten im Zeitzonenoffset darstellen.

• + (plus) oder – (minus) ist das erforderliche Zeichen für einen Zeitzonenoffset. Dies gibt an, ob der Zeitzonenoffset zur UTC-Zeit addiert oder von dieser subtrahiert wird, um die lokale Zeit zu bestimmen. Der gültige Zeitzonenoffset liegt im Bereich von -14: 00 bis +14: 00.

Der Zeitzonenoffsetbereich entspricht dem W3C XML-Standard für die XSD-Schemadefinition und weicht geringfügig von der SQL 2003-Standarddefinition (12:59 bis +14:00) ab.

Der optionale Parameter vom Typ fractional seconds precision gibt die Anzahl der Ziffern für den Bruchteil der Sekunden an. Dieser Wert kann eine ganze Zahl von 0 bis 7 (100 Nanosekunden) sein. Der Standardwert von fractional seconds precision beträgt 100 ns (sieben Ziffern für den Bruchteil der Sekunden).

Die Daten werden in der Datenbank gespeichert und auf dem Server entsprechend der UTC-Zeit verarbeitet, verglichen, sortiert und indiziert. Der Zeitzonenoffset bleibt in der Datenbank zum Abruf erhalten.

Es wird davon ausgegangen, dass der angegebene Zeitzonenoffset die Sommerzeit beachtet und für jeden angegebenen datetime-Wert, der in der Sommerzeit liegt, angepasst wird.

Beim datetimeoffset-Datentyp wird bei Einfüge-, Update-, Konvertierungs- oder Zuweisungsvorgängen oder bei arithmetischen Vorgängen sowohl der UTC-Wert als auch der (für den persistenten oder konvertierten Zeitzonenoffset) lokale datetime-Wert überprüft. Wird ein ungültiger UTC-Wert oder (für den persistenten oder konvertierten Zeitzonenoffset) lokaler datetime-Wert erkannt, wird ein Fehler wegen eines ungültigen Werts ausgelöst. 9999-12-31 10:10:00 ist z. B. im UTC-Format gültig, führt bei der lokalen Zeit aber zu einer Überschreitung des Zeitzonenoffsets +13:50.

Kompatibilität mit ANSI und ISO 8601

Die Abschnitte der Themen zur Kompatibilität mit ANSI und ISO 8601 von date und time gelten auch für datetimeoffset.

Abwärtskompatibilität für Downlevelclients

Einige Clients früherer Versionen bieten keine Unterstützung der Datentypen time, date, datetime2 und datetimeoffset. In der folgenden Tabelle wird die Typzuordnung zwischen einer Instanz höherer Ebene in SQL Server und Downlevelclients gezeigt.

Konvertieren von Datums- und Zeitdaten

Beim Konvertieren in date- und time-Datentypen lehnt SQL Server alle Werte ab, die nicht als Datum oder Uhrzeit erkannt werden. Informationen zur Verwendung der CAST-Funktion und der CONVERT-Funktion mit Datums- und Uhrzeitdaten finden Sie unter CAST und CONVERT (Transact-SQL).

Konvertieren des datetimeoffset-Datentyps in andere Datums- und Uhrzeittypen

Die folgende Tabelle veranschaulicht die Abläufe bei der Konvertierung des datetimeoffset-Datentyps in andere Datums- und Uhrzeitdatentypen.

DECLARE @datetimeoffset datetimeoffset(4) = '12-10-25 12:32:10 +01:00';
DECLARE @date date= @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset ', @date AS 'date';
--Result
--@datetimeoffset                date
-------------------------------- ----------
--2025-12-10 12:32:10.0000 +01:0 2025-12-10
--
--(1 row(s) affected)

DECLARE @datetimeoffset datetimeoffset(4) = '12-10-25 12:32:10.1237 +01:0';
DECLARE @time time(3) = @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset ', @time AS 'time';
--Result
--@datetimeoffset                time
-------------------------------- ------------
-- 2025-12-10 12:32:10.1237 +01:00    12:32:10.124
--
--(1 row(s) affected)

DECLARE @datetimeoffset datetimeoffset(4) = '12-10-25 12:32:10.1237 +01:0';
DECLARE @datetime datetime = @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset ', @datetime AS 'datetime';
--Result
--@datetimeoffset                datetime
-------------------------------- -----------------------
--2025-12-10 12:32:10.1237 +01:0 2025-12-10 12:32:10.123
--
--(1 row(s) affected)

DECLARE @datetimeoffset datetimeoffset(3) = '1912-10-25 12:24:32 +10:0';
DECLARE @smalldatetime smalldatetime = @datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset', @smalldatetime AS '@smalldatetime';
--Result
--@datetimeoffset                @smalldatetime
-------------------------------- -----------------------
--1912-10-25 12:24:32.000 +10:00 1912-10-25 12:25:00
--
--(1 row(s) affected)

DECLARE @datetimeoffset datetimeoffset(4) = '1912-10-25 12:24:32.1277 +10:0';
DECLARE @datetime2 datetime2(3)=@datetimeoffset;
SELECT @datetimeoffset AS '@datetimeoffset', @datetime2 AS '@datetime2';
--Result
@datetimeoffset                    @datetime2
---------------------------------- ----------------------
1912-10-25 12:24:32.1277 +10:00    1912-10-25 12:24:32.12
--(1 row(s) affected)

Konvertieren von Zeichenfolgenliteralen in datetimeoffset

Konvertierungen von Zeichenfolgenliteralen in Datums- und Zeitwerte sind erlaubt, wenn alle Teile der Zeichenfolge in gültigen Formaten vorliegen. Andernfalls wird ein Laufzeitfehler ausgelöst. Wird bei impliziten oder expliziten Konvertierungen von Datums- und Zeitwerten in Zeichenfolgenliterale kein Stil angegeben, wird das Standardformat der aktuellen Sitzung verwendet. In der folgenden Tabelle werden die Regeln zum Konvertieren eines Zeichenfolgenliterals in den datetimeoffset-Datentyp dargestellt.

Beispiele

Im folgenden Beispiel werden die Ergebnisse der Umwandlung von einer Zeichenfolge in alle date-Datentypen und time-Datentypen verglichen.

SELECT 
     CAST('2007-05-08 12:35:29. 1234567 +12:15' AS time(7)) AS 'time' 
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS date) AS 'date' 
    ,CAST('2007-05-08 12:35:29.123' AS smalldatetime) AS 
        'smalldatetime' 
    ,CAST('2007-05-08 12:35:29.123' AS datetime) AS 'datetime' 
    ,CAST('2007-05-08 12:35:29.1234567+12:15' AS datetime2(7)) AS 
        'datetime2'
    ,CAST('2007-05-08 12:35:29.1234567 +12:15' AS datetimeoffset(7)) AS 
        'datetimeoffset'
    ,CAST('2007-05-08 12:35:29.1234567+12:15' AS datetimeoffset(7)) AS
        'datetimeoffset IS08601';

Dies ist das Resultset.

Siehe auch

Verweis

CAST und CONVERT (Transact-SQL)