날짜 및 시간 데이터

아티클
03/13/2024

SQL Server 2008에는 날짜 및 시간 정보를 처리하기 위한 새로운 데이터 형식이 도입되었습니다. 새로운 데이터 형식에는 개별 날짜 형식과 시간 형식을 비롯하여 보다 큰 범위의 확장된 데이터 형식, 정밀도 및 표준 시간대 인식 기능이 포함됩니다. .NET Framework 버전 3.5 SP(서비스 팩) 1부터는 .NET Framework Data Provider for SQL Server(System.Data.SqlClient)에 SQL Server 2008 데이터베이스 엔진의 새로운 모든 기능이 완벽하게 지원됩니다. SqlClient에서 이러한 새 기능을 사용하려면 .NET Framework 3.5 SP1 이상을 설치해야 합니다.

SQL Server 2008보다 이전의 SQL Server 버전에는 날짜 및 시간 값을 사용하기 위한 두 가지 데이터 형식 datetime 및 smalldatetime이 있습니다. 두 데이터 형식 모두 날짜 값과 시간 값을 모두 포함하므로 날짜나 시간 값만 가지고 작업하기는 어려웠습니다. 또한 이들 데이터 형식은 1753년 영국에 양력이 도입된 이후의 날짜만 지원합니다. 또 다른 제한 사항은 이러한 이전 데이터 형식이 표준 시간대를 인식하지 못해 여러 표준 시간대에서 발생하는 데이터로 작업하기가 어렵다는 것입니다.

SQL Server의 날짜 및 시간 형식에 대한 자세한 내용은 날짜 및 시간 데이터 형식 및 함수를 참조하세요.

SQL Server 2008에 도입된 날짜/시간 데이터 형식

다음 표에서는 새로운 날짜 및 시간 데이터 형식에 대해 설명합니다.

SQL Server 데이터 형식	설명
`date`	`date` 데이터 형식은 하루 단위이며 범위는 01년 1월 1일부터 9999년 12월 31일까지입니다. 기본값은 1900년 1월 1일입니다. 스토리지 크기는 3바이트입니다.
`time`	`time` 데이터 형식은 24시간제를 기준으로 시간 값만 저장합니다. `time` 데이터 형식의 범위는 00:00:00.0000000~23:59:59.9999999이며 정확도는 100나노초입니다. 기본값은 00:00:00.0000000(자정)입니다. `time` 데이터 형식은 초에 대해 소수로 표현되는 사용자 정의 정밀도를 지원하며 지정된 정밀도에 따라 스토리지 크기는 3바이트에서 6바이트까지의 범위 내에서 달라집니다.
`datetime2`	`datetime2` 데이터 형식은 `date` 및 `time` 데이터 형식의 범위와 정밀도를 하나의 데이터 형식으로 통합합니다. 기본값과 문자열 리터럴 형식은 `date` 및 `time` 데이터 형식에 정의된 값과 동일합니다.
`datetimeoffset`	`datetimeoffset` 데이터 형식은 `datetime2`의 모든 기능을 포함하며 표준 시간대 오프셋 기능을 추가로 지원합니다. 표준 시간대 오프셋은 [+\|-] HH:MM으로 표현됩니다. HH는 00부터 14까지의 두 자리 숫자로, 표준 시간대 오프셋의 시간을 나타냅니다. MM은 00부터 59까지의 두 자리 숫자로, 표준 시간대 오프셋의 분을 나타냅니다. 시간 형식은 100나노초까지 지원합니다. 필수 값인 + 또는 - 부호는 현지 시간을 얻기 위해 표준 시간대 오프셋을 UTC(Universal Time Coordinate 또는 그리니치 표준시)에 더할 것인지 또는 UTC에서 뺄 것인지를 나타냅니다.

참고 항목

Type System Version 키워드 사용에 관한 자세한 내용은 ConnectionString을 참조하세요.

날짜 형식 및 날짜 순서

SQL Server에서 날짜 및 시간 값을 구문 분석하는 방법은 형식 시스템 버전과 서버 버전뿐만 아니라 서버의 기본 언어 설정과 형식 설정에 따라 달라집니다. 특정 언어의 날짜 형식에 사용할 수 있는 날짜 문자열이라도 다른 언어와 날짜 형식 설정을 사용하는 연결에서 쿼리를 실행할 경우 인식되지 않을 수 있습니다.

Transact-SQL SET LANGUAGE 문은 날짜 부분의 순서를 결정하는 DATEFORMAT을 암시적으로 설정합니다. 연결에 SET DATEFORMAT Transact-SQL 문을 사용하면 날짜 부분을 MDY, DMY, YMD, YDM, MYD 또는 DYM 순서로 정렬하여 날짜 값을 명확하게 나타낼 수 있습니다.

연결에 대해 DATEFORMAT을 지정하지 않으면 SQL Server는 연결과 연결된 기본 언어를 사용합니다. 예를 들어 '01/02/03'의 경우 언어가 영어(미국)로 설정된 서버에서는 MDY(January 2, 2003)로 해석되고 언어가 영어(영국)로 설정된 서버에서는 DMY(February 1, 2003)로 해석됩니다. 연도는 세기 값의 구분 기준 날짜를 정의하는 SQL Server의 연도 구분 규칙을 사용하여 결정됩니다. 자세한 내용은 2자리 연도 구분 옵션을 참조하세요.

참고 항목

YDM 날짜 형식은 문자열 형식에서 date, time, datetime2 또는 datetimeoffset으로 변환할 경우 지원되지 않습니다.

SQL Server가 날짜 및 시간 데이터를 해석하는 방법에 대한 자세한 내용은 날짜 및 시간 데이터 사용을 참조하세요.

날짜/시간 데이터 형식 및 매개 변수

새 날짜 및 시간 데이터 형식을 지원하기 위해 다음 열거형이 SqlDbType에 추가되었습니다.

SqlDbType.Date
SqlDbType.Time
SqlDbType.DateTime2
SqlDbType.DateTimeOffSet

위의 SqlDbType 열거형 중 하나를 사용하여 SqlParameter의 데이터 형식을 지정할 수 있습니다.

참고 항목

SqlParameter의 DbType 속성을 SqlDbType.Date로 설정할 수 없습니다.

또한 SqlParameter 개체의 DbType 속성을 특정 SqlParameter 열거형 값으로 설정하면 일반적인 방식으로 DbType의 형식을 지정할 수 있습니다. datetime2 및 datetimeoffset 데이터 형식을 지원하기 위해 다음 열거형 값이 DbType에 추가되었습니다.

DbType.DateTime2
DbType.DateTimeOffset

이러한 새 열거형은 이전 버전의 .NET Framework에서 사용할 수 있는 Date, Time 및 DateTime 열거형을 보완합니다.

매개 변수 개체의 .NET Framework 데이터 공급자 형식은 매개 변수 개체 값의 .NET Framework 형식이나 매개 변수 개체의 DbType에서 유추됩니다. 새 날짜 및 시간 데이터 형식을 지원하기 위해 도입된 새 System.Data.SqlTypes 데이터 형식은 없습니다. 다음 표에서는 SQL Server 2008 날짜 및 시간 데이터 형식과 CLR 데이터 형식 간의 매핑에 대해 설명합니다.

SQL Server 데이터 형식	.NET Framework 형식	System.Data.SqlDbType	System.Data.DbType
날짜	System.DateTime	날짜	날짜
time	System.TimeSpan	Time	Time
datetime2	System.DateTime	DateTime2	DateTime2
datetimeoffset	System.DateTimeOffset	DateTimeOffset	DateTimeOffset
날짜/시간	System.DateTime	DateTime	DateTime
smalldatetime	System.DateTime	DateTime	DateTime

SqlParameter 속성

다음 표에서는 날짜 및 시간 데이터 형식과 관련된 SqlParameter 속성을 설명합니다.

속성	설명
IsNullable	값이 nullable인지 여부를 가져오거나 설정합니다. 서버에 null 매개 변수 값을 보낼 때는 DBNull(Visual Basic에서는 `null`)이 아니라 `Nothing`을 지정해야 합니다. 데이터베이스 null에 대한 자세한 내용은 Handling Null Values를 참조하세요.
Precision	값을 나타내는 데 사용되는 최대 자릿수를 가져오거나 설정합니다. 날짜 및 시간 데이터 형식에서는 이 설정이 무시됩니다.
Scale	`Time`, `DateTime2`및 `DateTimeOffset`에 대해 값의 시간 부분이 확인되는 소수 자릿수를 가져오거나 설정합니다. 기본값은 0이며 이는 값에서 실제 자릿수가 유추되어 서버에 전송됨을 의미합니다.
Size	날짜 및 시간 데이터 형식에서 무시됩니다.
Value	매개 변수 값을 가져오거나 설정합니다.
SqlValue	매개 변수 값을 가져오거나 설정합니다.

참고 항목

0보다 작거나 24시간보다 크거나 같은 시간 값은 ArgumentException을 throw합니다.

매개 변수 만들기

SqlParameter 개체는 해당 생성자를 사용하거나, SqlCommand의 Parameters 메서드를 호출하여 AddSqlParameterCollection 컬렉션에 추가하는 방법으로 만들 수 있습니다. Add 메서드는 생성자 인수 또는 기존 매개 변수 개체를 입력으로 사용합니다.

이 항목의 다음 섹션에서는 날짜 및 시간 매개 변수를 지정하는 방법에 대한 예제를 제공합니다. 매개 변수 작업에 대한 추가 예는 매개 변수 및 매개 변수 데이터 형식 구성 및 DataAdapter 매개 변수를 참조하세요.

Date 예제

다음 코드 조각에서는 date 매개 변수를 지정하는 방법을 보여 줍니다.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Date";
parameter.SqlDbType = SqlDbType.Date;
parameter.Value = "2007/12/1";

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Date"
parameter.SqlDbType = SqlDbType.Date
parameter.Value = "2007/12/1"

Time 예제

다음 코드 조각에서는 time 매개 변수를 지정하는 방법을 보여 줍니다.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@time";
parameter.SqlDbType = SqlDbType.Time;
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Time"
parameter.SqlDbType = SqlDbType.Time
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;

Datetime2 예제

다음 코드 조각에서는 날짜 부분과 시간 부분이 모두 포함된 datetime2 매개 변수를 지정하는 방법을 보여 줍니다.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Datetime2";
parameter.SqlDbType = SqlDbType.DateTime2;
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Datetime2"
parameter.SqlDbType = SqlDbType.DateTime2
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");

DateTimeOffSet 예제

다음 코드 예제에서는 날짜, 시간 및 표준 시간대 오프셋이 0으로 설정된 DateTimeOffSet 매개 변수를 지정하는 방법을 보여 줍니다.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@DateTimeOffSet";
parameter.SqlDbType = SqlDbType.DateTimeOffSet;
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@DateTimeOffSet"
parameter.SqlDbType = SqlDbType.DateTimeOffSet
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");

AddWithValue

다음 코드 조각과 같이 SqlCommand의 AddWithValue 메서드를 사용하여 매개 변수를 제공할 수도 있습니다. 그러나 AddWithValue 메서드를 사용할 경우 매개 변수에 DbType 또는 SqlDbType을 지정할 수 없습니다.

command.Parameters.AddWithValue(
    "@date", DateTimeOffset.Parse("16660902"));

command.Parameters.AddWithValue( _
    "@date", DateTimeOffset.Parse("16660902"))

@date 매개 변수는 서버의 date, datetime또는 datetime2 데이터 형식에 매핑할 수 있습니다. 새 datetime 데이터 형식을 사용할 때는 인스턴스의 데이터 형식을 매개 변수의 SqlDbType 속성에 명시적으로 설정해야 합니다. Variant를 사용하거나 암시적으로 매개 변수 값을 제공할 경우 datetime 및 smalldatetime 데이터 형식에 대한 이전 버전과의 호환성에 문제가 발생할 수 있습니다.

다음 표에서는 각 CLR 형식에서 유추되는 SqlDbTypes을 보여 줍니다.

CLR 형식	유추되는 SqlDbType
DateTime	SqlDbType.DateTime
TimeSpan	SqlDbType.Time
DateTimeOffset	SqlDbType.DateTimeOffset