@@DATEFIRST (Transact-SQL)

Возвращает текущее значение параметра SET DATEFIRST для сеанса.

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

Синтаксические обозначения в Transact-SQL

Синтаксис

@@DATEFIRST

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

tinyint

Замечания

Инструкция SET DATEFIRST задает первый день недели. Для языкового стандарта «U.S. English» значением по умолчанию является 7 (воскресенье).

Этот языковой параметр влияет на интерпретацию символьных строк при их преобразовании в значения дат для хранения в базе данных и отображения значений дат, хранящихся в этой базе данных. Он не влияет на формат хранения данных для дат. В следующем примере язык сначала устанавливается на 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

См. также

Справочник

Функции конфигурации (Transact-SQL)