TODATETIMEOFFSET (Transact-SQL)

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

Transact-SQL-Syntaxkonventionen

Syntax

TODATETIMEOFFSET ( expression , time_zone )

Argumente

• 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.

• time_zone
  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). Der Ausdruck wird in Ortszeit für die angegebene time_zone 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-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 2007-08-30 15:51:34.7030000 -07:00

B.Ändern des Zeitzonenoffsets zu Minuten

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

DECLARE @todaysDate datetime2;
SET @todaysDate = GETDATE();
SELECT TODATETIMEOFFSET (@todaysDate, -120);
-- RETURNS 2007-08-30 15:52:37.8770000 -02:00

C.Hinzufügen eines 13-Stunden-Zeitzonenoffsets

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

DECLARE @dateTime datetimeoffset(7)= '2007-08-28 18:00:30';
SELECT TODATETIMEOFFSET (@dateTime, '+13:00');
-- RETURNS 2007-08-28 18:00:30.0000000 +13:00

Siehe auch

Verweis

CAST und CONVERT (Transact-SQL)

Datums- und Uhrzeitdatentypen und zugehörige Funktionen (Transact-SQL)