SWITCHOFFSET (Transact-SQL)

Retourne une valeur datetimeoffset de l'offset de fuseau horaire stocké qui est remplacée par un nouvel offset de fuseau horaire spécifié.

Pour obtenir une vue d'ensemble de tous les types de données et fonctions de date et d'heure Transact-SQL, consultez Fonctions de date et d'heure (Transact-SQL). Pour obtenir des informations et des exemples communs aux types de données et fonctions de date et d'heure, consultez Utilisation des données de date et d'heure.

Conventions de syntaxe Transact-SQL

Syntaxe

SWITCHOFFSET ( DATETIMEOFFSET, time_zone ) 

Arguments

• DATETIMEOFFSET
  Expression qui peut être résolue en une valeur datetimeoffset(n).

• time_zone
  Chaîne de caractères au format [+|-]TZH:TZM ou entier signé (de minutes) qui représente l'offset de fuseau horaire, et qui est supposé être réglé et prendre en charge l'heure d'été.

Type de retour

datetimeoffset avec la précision de fraction de l'argument DATETIMEOFFSET.

Notes

Utilisez SWITCHOFFSET pour sélectionner une valeur datetimeoffset dans un offset de fuseau horaire qui est différent de l'offset de fuseau horaire stocké à l'origine. SWITCHOFFSET ne met pas à jour la valeur time_zone stockée.

SWITCHOFFSET peut être utilisé pour mettre à jour une colonne datetimeoffset.

Exemples

L'exemple suivant utilise SWITCHOFFSET pour afficher un offset de fuseau horaire différent de la valeur stockée dans la base de données.

CREATE TABLE dbo.test 
    (
    ColDatetimeoffset datetimeoffset
    );
GO
INSERT INTO dbo.test 
VALUES ('1998-09-20 7:45:50.71345 -5:00');
GO
SELECT SWITCHOFFSET (ColDatetimeoffset, '-08:00') 
FROM dbo.test;
GO
--Returns: 1998-09-20 04:45:50.7134500 -08:00
SELECT ColDatetimeoffset
FROM dbo.test;
--Returns: 1998-09-20 07:45:50.7134500 -05:00

Voir aussi

Référence

CAST et CONVERT (Transact-SQL)