• Article

@@DATEFIRST (Transact-SQL)

Retourne la valeur actuelle, pour une session, de SET DATEFIRST.

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.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

@@DATEFIRST

Type de retour

tinyint

Notes

SET DATEFIRST spécifie le premier jour de la semaine. Pour les États-Unis, la valeur par défaut est 7 (dimanche).

Ce paramètre de langue affecte l'interprétation de chaînes de caractères lorsqu'elles sont converties en valeurs de date pour le stockage dans la base de données, et l'affichage des valeurs de date qui sont stockées dans la base de données. Ce paramètre n'affecte pas le format de stockage des données de date. Dans l'exemple suivant, la langue a d'abord pour valeur Italian. L'instruction SELECT @@DATEFIRST; retourne 1. La langue prend ensuite pour valeur us_english. L'instruction SELECT @@DATEFIRST; retourne 7.

SET LANGUAGE Italian;
GO
SELECT @@DATEFIRST;
GO
SET LANGUAGE us_english;
GO
SELECT @@DATEFIRST;

Exemple

L'exemple suivant définit le premier jour de la semaine à 5 (vendredi) et considère que le jour actuel, Today, est samedi. L'instruction SELECT retourne la valeur DATEFIRST et le numéro du jour actuel de la semaine.

SET DATEFIRST 5;
SELECT @@DATEFIRST AS 'First Day'
    ,DATEPART(dw, SYSDATETIME()) AS 'Today';

Voici l'ensemble des résultats.

First Day         Today
----------------  --------------
5                 2