@@DATEFIRST (Transact-SQL)
Gilt für: 
SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric
Diese Funktion gibt den aktuellen Wert von SET DATEFIRST für eine bestimmte Sitzung zurück.
Eine Übersicht über alle Datums- und Uhrzeitdatentypen und zugehörigen Funktionen für Transact-SQL finden Sie unter Datums- und Uhrzeitdatentypen und zugehörige Funktionen (Transact-SQL).
Transact-SQL-Syntaxkonventionen
Syntax
@@DATEFIRST
Rückgabetyp
tinyint
Bemerkungen
SET DATEFIRST n gibt den ersten Tag der Woche an (Sonntag, Montag, Dienstag usw.). Der Wert n liegt zwischen 1 und 7.
SET DATEFIRST 3;
GO
SELECT @@DATEFIRST; -- 3 (Wednesday)
GO
Bei einer US-englischen Umgebung ist der Wert @@DATEFIRST standardmäßig 7 (Sonntag).
Diese Spracheinstellung beeinflusst die Interpretierung von Zeichenfolgen, da SQL Server diese Zeichenfolgen in Datumswerte zum Speichern in der Datenbank konvertiert. Diese Einstellung beeinflusst außerdem die Anzeige von Datumswerten in der Datenbank. Diese Einstellung beeinflusst nicht das Speicherformat der Datumsdaten.
In diesem Beispiel wird die Sprache zunächst auf Italian festgelegt. Die SELECT @@DATEFIRST;-Anweisung gibt 1 zurück. Die nächste Anweisung legt die Sprache auf us_english fest. Die letzte Anweisung, SELECT @@DATEFIRST;, gibt 7 zurück.
SET LANGUAGE Italian;
GO
SELECT @@DATEFIRST;
GO
SET LANGUAGE us_english;
GO
SELECT @@DATEFIRST;
Beispiele
In diesem Beispiel wird der erste Tag der Woche auf 5 (Freitag) festgelegt und davon ausgegangen, dass der aktuelle Tag (Today) Samstag ist. Die SELECT-Anweisung gibt den DATEFIRST-Wert und die Zahl des aktuellen Tages der Woche zurück.
SET DATEFIRST 5;
SELECT @@DATEFIRST AS 'First Day'
,DATEPART(dw, SYSDATETIME()) AS 'Today';
Hier sehen Sie das Ergebnis.
First Day Today
---------------- --------------
5 2
Beispiel
Azure Synapse Analytics und Analytics-Plattformsystem (PDW)
SELECT @@DATEFIRST;