TODATEDATETIMEOFFSET (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database w Microsoft Fabric

Zwraca wartość datetimeoffset , która jest tłumaczona z wyrażenia datetime2 .

Transact-SQL konwencje składni

Składnia

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Arguments

datetime_expression
To wyrażenie , które rozwiązuje się do wartości datetime2 .

Uwaga / Notatka

Wyrażenie nie może być typu tekst, ntext ani obraz, ponieważ tych typów nie można domyślnie przekształcić na varchar lub nvarchar.

timezoneoffset_expression
To wyrażenie reprezentujące przesunięcie strefy czasowej w minutach (jeśli jest to liczba całkowita), na przykład -120, lub godzinach i minutach (jeśli jest to ciąg znaków), na przykład '+13:00'. Zakres wynosi od +14 do -14 (w godzinach). Wyrażenie interpretowane jest w czasie lokalnym dla określonego timezoneoffset_expression.

Uwaga / Notatka

Jeśli wyrażenie jest ciągiem znaków, musi być w formacie {+|-}TZH:THM.

Zwracany typ

Datetimetimeoffset. Precyzja ułamkowa jest taka sama jak argument datetime_expression .

Przykłady

A. Zmiana przesunięcia strefy czasowej względem aktualnej daty i godziny

Poniższy przykład zmienia przesunięcie strefy bieżącej daty i czasu do czasu -07:00.

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

B. Zmiana strefy czasowej w ciągu kilku minut

Poniższy przykład zmienia aktualną strefę czasową na -120 minuty.

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

C. Dodanie 13-godzinnego przesunięcia strefy czasowej

Poniższy przykład dodaje przesunięcie strefy czasowej o 13 godzin do daty i godziny.

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

Zobacz też

RZUTOWANIE i konwertowanie (Transact-SQL)
Typy danych i funkcje datowe i czasowe (Transact-SQL)
W STREFIE CZASOWEJ (Transact-SQL)