@@DATEFIRST(Transact-SQL)

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW) Microsoft Fabric의 SQL 분석 엔드포인트 Microsoft Fabric의 웨어하우스

이 함수는 특정 세션에 대해 SET DATEFIRST의 현재 값을 반환합니다.

모든 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 및 분석 플랫폼 시스템(PDW)

SELECT @@DATEFIRST;