TODATETIMEOFFSET (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Gibt einen datetimeoffset-Wert zurück, der von einem datetime2-Ausdruck übersetzt wird.

Transact-SQL-Syntaxkonventionen

Syntax

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

datetime_expression
Ein Ausdruck, der zu einem datetime2-Wert aufgelöst wird.

Hinweis

Ein Ausdruck kann nicht vom Typ text, ntext oder image sein, da diese Typen nicht implizit in varchar oder nvarchar konvertiert werden können.

timezoneoffset_expression
Ein Ausdruck, der den Zeitzonenoffset in Minuten (bei einer ganzen Zahl), z.B. -120, oder in Stunden und Minuten (bei einer Zeichenfolge), z.B. „+13:00“ darstellt. Der Bereich liegt zwischen +14 und -14 (in Stunden). Für die timezoneoffset_expression-Angabe wird der Ausdruck in Ortszeit interpretiert.

Hinweis

Wenn der Ausdruck eine Zeichenfolge ist, muss er folgendes Format aufweisen: {+ | -} TZH:THM.

Rückgabetyp

datetimeoffset. Die Genauigkeit der Bruchteile entspricht der des datetime_expression-Arguments.

Beispiele

A. Ändern des Zeitzonenoffsets für das aktuelle Datum und die aktuelle Uhrzeit

Im folgenden Beispiel ändert sich der Zeitzonenoffset des aktuellen Datums und der aktuellen Uhrzeit zur Zeitzone -07:00.

DECLARE @todaysDateTime DATETIME2;  
SET @todaysDateTime = GETDATE();  
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');  
-- RETURNS 2019-04-22 16:23:51.7666667 -07:00  

B. Ändern des Zeitzonenoffsets zu Minuten

Im folgenden Beispiel ändert sich die aktuelle Zeitzone zu -120 Minuten.

SELECT TODATETIMEOFFSET(SYSDATETIME(), -120)
-- RETURNS: 2019-04-22 11:39:21.6986813 -02:00  

C. Hinzufügen eines 13-Stunden-Zeitzonenoffsets

Im folgenden Beispiel wird ein 13-Stunden-Zeitzonenoffset einem Datum und einer Uhrzeit hinzugefügt.

SELECT TODATETIMEOFFSET(SYSDATETIME(), '+13:00')
-- RETURNS: 2019-04-22 11:39:29.0339301 +13:00

Weitere Informationen

CAST und CONVERT (Transact-SQL)
Datums- und Uhrzeitdatentypen und zugehörige Funktionen (Transact-SQL)
AT TIME ZONE (Transact-SQL)