날짜 및 시간 함수
.NET Framework Data Provider for SQL Server(SqlClient)에서는 System.DateTime 입력 값에 대해 연산을 수행하고 string, 숫자 또는 System.DateTime 값 결과를 반환하는 날짜 및 시간 함수를 제공합니다. 이 함수는 SqlClient를 사용할 때 사용 가능한 SqlServer 네임스페이스에 있습니다. 공급자의 네임스페이스 속성이 있으면 특정 구문(예: 형식 및 함수)에 대해 이 공급자가 사용하는 접두사를 Entity Framework에서 찾을 수 있습니다. 다음 표에서는 SqlClient 날짜 및 시간 함수를 보여 줍니다.
| 함수 | 설명 |
|---|---|
DATEADD(datepart, number, date) |
지정한 날짜에 시간 간격을 추가하여 새 DateTime 값을 반환합니다.인수 datepart: 새 값을 반환할 날짜 부분을 나타내는 String입니다.number: Int32에 더해지는 Int64, Decimal, Double 또는 datepart 값입니다.date: 전체 자릿수가 [0-7]인 DateTime, DateTimeOffset, Time 또는 날짜 형식의 문자열을 반환하는 식입니다.반환 값 전체 자릿수가 [0-7]인 새 DateTime, DateTimeOffset 또는 Time 값입니다.예제 SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
지정한 두 날짜 사이에 있는 날짜 및 시간 경계의 수를 반환합니다. 인수 datepart: 차이를 계산할 날짜 부분을 나타내는 String입니다.startdate: 계산의 시작 날짜는 전체 자릿수가 [0-7]인 DateTime, DateTimeOffset, Time 값 또는 날짜 형식의 문자열을 반환하는 식입니다.enddate: 계산의 끝 날짜는 전체 자릿수가 [0-7]인 DateTime, DateTimeOffset, Time 값 또는 날짜 형식의 문자열을 반환하는 식입니다.반환 값 Int32입니다.예제 SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
지정한 날짜에서 특정 datepart를 나타내는 문자열을 반환합니다. 인수 datepart: 새 값을 반환할 날짜 부분을 나타내는 String입니다.date: 전체 자릿수가 [0-7]인 DateTime,, DateTimeOffset, Time 값 또는 날짜 형식의 문자열을 반환하는 식입니다.반환 값 지정한 날짜의 지정한 부분을 나타내는 문자열입니다. 예제 SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
지정한 날짜의 지정된 datepart를 나타내는 정수를 반환합니다. 인수 datepart: 새 값을 반환할 날짜 부분을 나타내는 String입니다.date: 전체 자릿수가 [0-7]인 DateTime,, DateTimeOffset,, Time 값 또는 날짜 형식의 문자열을 반환하는 식입니다.반환 값 지정한 날짜의 지정한 부분을 나타내는 Int32입니다.예제 SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
지정된 날짜의 일 부분을 정수로 반환합니다. 인수 date:전체 자릿수가 0-7인 DateTime 또는 DateTimeOffset 형식의 식입니다.반환 값 지정한 날짜의 일을 나타내는 Int32입니다.예제 SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
현재 날짜와 시간을 datetime 값에 대한 SQL Server 내부 형식으로 생성합니다. 반환 값 DateTime 형식이며 전체 자릿수가 3인 현재 시스템 날짜 및 시간입니다.예제 SqlServer.GETDATE() |
GETUTCDATE() |
datetime 값을 UTC(Coordinated Universal Time 또는 그리니치 표준시) 형식으로 생성합니다. 반환 값 전체 자릿수가 3인 UTC 형식의 DateTime 값입니다.예제 SqlServer.GETUTCDATE() |
MONTH(date) |
지정한 날짜의 월을 정수로 반환합니다. 인수 date:전체 자릿수가 0-7인 DateTime 또는 DateTimeOffset 형식의 식입니다.반환 값 지정한 날짜의 월을 나타내는 Int32입니다.예제 SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
지정한 날짜의 연도를 정수로 반환합니다. 인수 date:전체 자릿수가 0-7인 DateTime 또는 DateTimeOffset 형식의 식입니다.반환 값 지정한 날짜의 연도를 나타내는 Int32입니다.예제 SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
전체 자릿수가 7인 DateTime 값을 반환합니다.반환 값 전체 자릿수가 7인 DateTime 값입니다.예제 SqlServer.SYSDATETIME() |
SYSUTCDATE() |
datetime 값을 UTC(Coordinated Universal Time 또는 그리니치 표준시) 형식으로 생성합니다. 반환 값 전체 자릿수가 7인 UTC 형식의 DateTime 값입니다.예제 SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
전체 자릿수가 7인 DateTimeOffset을 반환합니다.반환 값 전체 자릿수가 7인 UTC 형식의 DateTimeOffset 값입니다.예제 SqlServer.SYSDATETIMEOFFSET() |
SqlClient가 지원하는 날짜 및 시간 함수에 대한 자세한 내용은 날짜 및 시간 데이터 형식 및 함수(Transact-SQL)를 참조하세요.