TODATETIMEOFFSET (Transact-SQL)

Artikel
10/16/2024

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics 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 )

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)

Freigeben über