@@DATEFIRST (Transact-SQL)
S’applique à : point de terminaison d’analytique SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW) SQL Analytics dans Microsoft Fabric Warehouse dans 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
Remarque
Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.
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;