TODATETIMEOFFSET (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

Geeft een datetimeoffset-waarde terug die is vertaald uit een datetime2-expressie .

Transact-SQL syntaxis-conventies

Syntaxis

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Arguments

datetime_expression
Is een uitdrukking die oplost tot een datetime2-waarde .

Opmerking

De uitdrukking kan geen type tekst, ntext of afbeelding zijn, omdat deze types niet impliciet kunnen worden omgezet naar varchar of nvarchar.

timezoneoffset_expression
Is een uitdrukking die de tijdzone-offset in minuten (als het geheel getal is) weergeeft, bijvoorbeeld -120, of uren en minuten (als het een string is), bijvoorbeeld '+13:00'. Het bereik is +14 tot -14 (in uren). De uitdrukking wordt geïnterpreteerd in lokale tijd voor de gespecificeerde timezoneoffset_expression.

Opmerking

Als de expressie een tekenreeks is, moet deze in het formaat {+|-}TZH:THM zijn.

Retourtype

Datumtijdverschuiving. De fractionele precisie is hetzelfde als het datetime_expression argument.

Voorbeelden

Eén. Het wijzigen van de tijdzone-offset van de huidige datum en tijd

Het volgende voorbeeld verandert de zone-offset van de huidige datum en de tijd naar de tijdzone -07:00.

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

B. De tijdzone-offset in minuten veranderen

Het volgende voorbeeld verandert de huidige tijdzone in -120 minuten.

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

C. Toevoeging van een tijdzone-verplaatsing van 13 uur

Het volgende voorbeeld voegt een tijdzone-offset van 13 uur toe aan een datum en tijd.

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

Zie ook

CAST en CONVERTEREN (Transact-SQL)
Datum- en tijdgegevenstypen en -functies (Transact-SQL)
TIJDZONE (Transact-SQL)