TODATETIMEOFFSET (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Renvoie une valeur datetimeoffset convertie à partir d’une expression datetime2.

Conventions de la syntaxe Transact-SQL

Syntaxe

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

datetime_expression
Expression qui est résolue en valeur datetime2.

Notes

L’expression ne peut pas être de type text, ntext ou image, car ces types ne sont pas implicitement convertibles en varchar ou nvarchar.

timezoneoffset_expression
Expression qui représente le décalage de fuseau horaire en minutes (pour un entier), par exemple -120, ou en heures et en minutes (pour une chaîne), par exemple « +13:00 ». La plage va de +14 à -14 (en heures). L’expression est interprétée en heure locale pour la valeur timezoneoffset_expression spécifiée.

Notes

Si l'expression est une chaîne de caractères, elle doit être au format {+|-}TZH:THM.

Type de retour

datetimeoffset. La précision fractionnelle est la même que l’argument datetime_expression.

Exemples

R. Modification du décalage de fuseau horaire de la date et de l'heure actuelles

L'exemple suivant modifie le décalage de fuseau horaire de la date et de l'heure actuelles au fuseau horaire -07:00.

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

B. Modification du décalage de fuseau horaire en minutes

L'exemple suivant modifie le fuseau horaire actuel à -120 minutes.

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

C. Ajout d'un décalage de fuseau horaire de 13 heures

L'exemple suivant ajoute un décalage de fuseau horaire de 13 heures à une date et une heure.

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

Voir aussi

CAST et CONVERT (Transact-SQL)
Types de données et fonctions de date et d'heure (Transact-SQL)
AT TIME ZONE (Transact-SQL)