TODATETIMEOFFSET (Transact-SQL)

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

Visszaad egy datetimeoffset értéket, amelyet egy datetime2 kifejezésből fordítanak le.

Transact-SQL szintaxis konvenciók

Szemantika

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Arguments

datetime_expression
Ez egy olyan kifejezés , amely datetime2 értékre bontódik.

Megjegyzés:

Az kifejezés nem lehet szövegtípus, ntext vagy kép , mert ezek a típusok nem alakíthatók be varcharra vagy nvarcharra.

timezoneoffset_expression
Egy olyan kifejezés, amely az időzóna eltolódását percekben (ha egész szám), például -120, vagy órák és percek (ha egy láncsor), például '+13:00'. A tartomány +14 és -14 között (órákban). Az kifejezést helyi időben értelmezik a megadott timezoneoffset_expression esetén.

Megjegyzés:

Ha az kifejezés karakterlánc, akkor a {+|-}TZH:THM formátumban kell lennie.

Visszatérési típus

Datetimeoffset. A törtfokú pontosság megegyezik a datetime_expression érvel.

Példák

A. Az aktuális dátum és idő időzóna eltérésének megváltoztatása

A következő példa megváltoztatja a jelenlegi dátum és idő zónaeltolását időzónára -07:00.

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

B. Az időzóna elmozdulásának módosítása percekben

A következő példa a jelenlegi időzónát percekre -120 változtatja.

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

C. 13 órás időzóna eltolás hozzáadása

A következő példa egy 13 órás időzóna eltolást ad hozzá egy dátumhoz és időponthoz.

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

Lásd még:

CAST és CONVERT (Transact-SQL)
Dátum és idő adattípusok és függvények (Transact-SQL)
IDŐZÓNÁBAN (Transact-SQL)