TODATETIMEOFFSET (Transact-SQL)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-databas i Microsoft Fabric

Returnerar ett datetimeoffset-värde som är översatt från ett datetime2-uttryck .

Transact-SQL syntaxkonventioner

Syntax

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Arguments

datetime_expression
Är ett uttryck som löser sig till ett datetime2-värde .

Anmärkning

Uttrycket kan inte vara av typ , text,ntext eller bild eftersom dessa typer inte kan konverteras implicit till varchar eller nvarchar.

timezoneoffset_expression
Är ett uttryck som representerar tidszonsförskjutningen i minuter (om det är ett heltal), till exempel -120, eller timmar och minuter (om en sträng), till exempel '+13:00'. Intervallet är +14 till -14 (i timmar). Uttrycket tolkas i lokal tid för den angivna timezoneoffset_expression.

Anmärkning

Om uttrycket är en teckensträng måste det vara i formatet {+|-}TZH:THM.

Returtyp

Datumtidsförskjutning. Den bråkade precisionen är densamma som i datetime_expression argumentet.

Examples

A. Att ändra tidszonsförskjutningen för det aktuella datumet och tiden

Följande exempel ändrar zonförskjutningen för det aktuella datumet och tiden till tidszonen -07:00.

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

B. Ändra tidszonsförskjutningen på några minuter

Följande exempel ändrar den aktuella tidszonen till -120 minuter.

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

C. Lägger till en tidszonsförskjutning på 13 timmar

Följande exempel lägger till en tidszonsförskjutning på 13 timmar till ett datum och en tid.

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

Se även

CAST och CONVERT (Transact-SQL)
Datatyper och funktioner för datum och tid (Transact-SQL)
VID TIDSZON (Transact-SQL)