@@DATEFIRST (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Analyseendpunkt in Microsoft FabricLagerhaus in Microsoft FabricSQL-Datenbank in Microsoft Fabric

Diese Funktion gibt für eine bestimmte Sitzung den aktuellen Wert von SET DATEFIRSTzurü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 (SONNTAG, MONTAG, DIENSTAG usw.) der Woche an. Der Wert n liegt zwischen 1 und 7.

SET DATEFIRST 3;
GO  
SELECT @@DATEFIRST; -- 3 (Wednesday)
GO

Für eine US-Englisch-Umgebung steht @@DATEFIRST standardmäßig auf 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;  

Verwandte Inhalte

• Datums- und Uhrzeitdatentypen und zugehörige Funktionen (Transact-SQL)