@@DATEFIRST (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-Endpunkt in Microsoft FabricWarehouse 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  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) oder früher finden Sie unter Dokumentation zu früheren Versionen.

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 ist das Resultset.

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

Beispiel

Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

SELECT @@DATEFIRST;  

Weitere Informationen

Konfigurationsfunktionen (Transact-SQL)