@@DATEFIRST (Transact-SQL)
S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric
Cette fonction retourne la valeur actuelle de SET DATEFIRST pour une session spécifique.
Pour obtenir une vue d’ensemble de tous les types de données et toutes les fonctions de date et d’heure Transact-SQL, consultez Types de données et fonctions de date et d’heure (Transact-SQL).
Conventions de la syntaxe Transact-SQL
Syntaxe
@@DATEFIRST
Type de retour
tinyint
Notes
SET DATEFIRST n spécifie le premier jour (DIMANCHE, LUNDI, MARDI, etc.) de la semaine. La valeur de n est comprise entre 1 et 7.
SET DATEFIRST 3;
GO
SELECT @@DATEFIRST; -- 3 (Wednesday)
GO
Pour un environnement anglais (États-Unis) @@DATEFIRST a la valeur par défaut 7 (dimanche).
Ce paramètre de langue affecte l’interprétation des chaînes de caractères, car SQL Server convertit ces chaînes en valeurs de date pour le stockage de base de données. Il affecte également l’affichage des valeurs de date stockées dans la base de données. Il n’a pas d’impact sur le format de stockage des données de date.
L’exemple suivant définit d’abord la langue sur Italian
. L'instruction SELECT @@DATEFIRST;
retourne 1
. L’instruction suivante définit ensuite la langue sur us_english
. L’instruction finale, SELECT @@DATEFIRST;
, retourne 7
.
SET LANGUAGE Italian;
GO
SELECT @@DATEFIRST;
GO
SET LANGUAGE us_english;
GO
SELECT @@DATEFIRST;
Exemples
L’exemple suivant définit le premier jour de la semaine sur 5
(vendredi) et suppose que le jour actuel, Today
, tombe un 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 le jeu de résultats obtenu.
First Day Today
---------------- --------------
5 2
Exemple
Azure Synapse Analytics et Analytics Platform System (PDW)
SELECT @@DATEFIRST;