@@DATEFIRST (Transact-SQL)

Применимо к:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Эта функция возвращает текущее значение SET DATEFIRST, для конкретной сессии.

Обзор всех типов данных и функций даты и времени в языке Transact-SQL см. в статье Типы данных и функции даты и времени (Transact-SQL).

Соглашения о синтаксисе Transact-SQL

Синтаксис

@@DATEFIRST  

Тип возвращаемых данных

tinyint

Замечания

SET DATEFIRST n указывает первый день (ВОСКРЕСЕНЬЕ, ПОНЕДЕЛЬНИК, ВТОРНИК и т.д.) недели. Значение n лежит в диапазоне от 1 до 7.

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

Для американской английской среды @@DATEFIRST по умолчанию — 7 (воскресенье).

Эта настройка языка влияет на интерпретацию строк символов, поскольку SQL Server преобразует эти строки в значения дат для хранения базы данных. Эта настройка также влияет на отображение значений дат, хранящихся в базе данных. Эта настройка не влияет на формат хранения данных о дате.

В приведенном ниже примере сначала задается язык Italian. Инструкция SELECT @@DATEFIRST; возвращает значение 1. Следующая инструкция задает язык us_english. В последней инструкции SELECT @@DATEFIRST; возвращает значение 7.

SET LANGUAGE Italian;  
GO  
SELECT @@DATEFIRST;  
GO  
SET LANGUAGE us_english;  
GO  
SELECT @@DATEFIRST;  

Примеры

В приведенном ниже примере в качестве первого дня недели задается 5 (пятница) и предполагается, что текущий день Today приходится на субботу. Инструкция SELECT возвращает значение DATEFIRST и номер текущего дня недели.

SET DATEFIRST 5;  
SELECT @@DATEFIRST AS 'First Day'  
    ,DATEPART(dw, SYSDATETIME()) AS 'Today';  

Вот результирующий набор.

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

Пример

Система платформы Azure Synapse Analytics и Analytics (PDW)

SELECT @@DATEFIRST;  

Связанный контент

• Типы данных и функции даты и времени (Transact-SQL)