TODATETIMEOFFSET (Transact-SQL)

Retourne une valeur datetimeoffset convertie à partir de l'expression datetime2.

Conventions de syntaxe Transact-SQL

Syntaxe

TODATETIMEOFFSET ( expression , time_zone )

Arguments

• expression
  Une expression résolue en valeur datetime2.

  [!REMARQUE]

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

• time_zone
  Expression qui représente le décalage de fuseau horaire en minutes. La plage est comprise entre +14 et -13. L'expression est interprétée en heure locale pour le time_zone spécifié.

  [!REMARQUE]

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

Type de retour

datetimeoffset. La précision fractionnaire est la même que l'argument datetime.

Exemples

A.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
SELECT @todaysDateTime = GetDate();
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00')
-- RETURNS 2007-08-30 15:51:34.7030000 -07:00

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

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

DECLARE @todaysDate Datetime2
SELECT @todaysDate = GetDate();
SELECT TODATETIMEOFFSET (@todaysDate, -120)
-- RETURNS 2007-08-30 15:52:37.8770000 -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.

DECLARE @dateTime datetimeoffset(7)= '2007-08-28 18:00:30'
SELECT TODATETIMEOFFSET (@dateTime, '+13:00')
-- RETURNS 2007-08-28 18:00:30.0000000 +13:00

Voir aussi

Référence

CAST et CONVERT (Transact-SQL)