@@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.

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

Exemple

Azure Synapse Analytics et Analytics Platform System (PDW)

SELECT @@DATEFIRST;  

Voir aussi

Fonctions de configuration (Transact-SQL)