DateSerial 함수(Visual Basic)
업데이트: 2007년 11월
시간 정보가 자정(00:00:00)으로 설정된 상태에서 지정된 년, 월, 일을 나타내는 Date 값을 반환합니다.
Public Function DateSerial( _
ByVal [Year] As Integer, _
ByVal [Month] As Integer, _
ByVal [Day] As Integer _
) As DateTime
매개 변수
Year
필수적 요소. 1부터 9999까지의 Integer 식입니다. 그러나 이 범위 아래의 값도 사용할 수 있습니다. Year가 0부터 99인 경우에는 아래의 "설명" 부분에 나온 것처럼 1930과 2029 사이의 값으로 해석됩니다. Year가 1보다 작은 경우에는 현재 연도에서 해당 값을 뺍니다.Month
필수적 요소. 1부터 12까지의 Integer 식입니다. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다. Month의 값은 1만큼 오프셋되어 계산된 연도의 1월에 적용됩니다. 즉, (Month - 1)이 1월에 더해집니다. 필요한 경우에는 연도가 다시 계산됩니다. 다음은 Month 값이 계산된 결과입니다.Month가 1이면 계산된 연도의 1월입니다.
Month가 0이면 이전 연도의 12월입니다.
Month가 -1이면 이전 연도의 11월입니다.
Month가 13이면 다음 연도의 1월입니다.
Day
필수적 요소. 1부터 31까지의 Integer 식입니다. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다. Day의 값은 1만큼 오프셋되어 계산된 월의 1일에 적용됩니다. 즉, (Day - 1)이 해당 월의 1일에 더해집니다. 필요한 경우에는 월과 연도가 다시 계산됩니다. 다음은 Day 값이 계산된 결과입니다.Day가 1이면 계산된 월의 1일입니다.
Day가 0이면 이전 월의 마지막 날짜입니다.
Day가 -1이면 이전 월의 끝에서 두 번째 날짜입니다.
Day가 현재 월의 마지막 날짜 값을 넘으면 다음 월의 해당되는 날짜입니다. 예를 들어, Month가 4이고 Day가 31이면 5월 1일입니다.
설명
Windows 98 또는 Windows 2000에서 Year 인수가 두 자리 연도이면 해당 값은 사용자가 정의한 컴퓨터 설정에 따라 해석됩니다. 기본 설정에서는 0부터 29까지의 값이 2000년–2029년으로 해석되고 30부터 99까지의 값은 1930년–1999년으로 해석됩니다. 다른 모든 Year 인수에 대해서는 1924와 같은 네 자리 연도를 사용합니다.
이전 버전의 Windows에서 두 자리 연도는 앞에 설명된 기본값에 따라 해석됩니다. 함수가 올바른 값을 반환하도록 하려면 네 자리로 된 Year를 사용합니다.
다음 예제에서는 음수, 0 및 양수의 인수 값을 사용합니다. 이 예제에서 DateSerial 함수는 현재 연도의 10년 전 연도에서 3월 1일 이전 날짜를 나타내는 Date 값을 반환합니다. 즉, 10년 전 2월의 마지막 날짜를 반환합니다.
Dim EndFeb As Date = DateSerial(-10, 3, 0)
Month 또는 Day가 정상 범위를 벗어나면 다음으로 큰 단위가 적용됩니다. 예를 들어, 32일을 지정하면 해당 값은 Month의 값에 따라 1개월 1일부터 1개월 4일까지의 값으로 계산됩니다. Year가 9999보다 크거나, -2,147,483,648부터 2,147,483,647까지의 범위를 벗어나는 인수가 있으면 ArgumentException 오류가 발생합니다. 세 개의 인수로 지정된 날짜가 1년 1월 1일 00:00:00 전이거나 9999년 12월 31일 23:59:59 후인 경우 ArgumentOutOfRangeException 오류가 발생합니다.
Date 데이터 형식에는 시간 구성 요소가 포함됩니다. DateSerial은 이러한 구성 요소를 모두 0으로 설정하므로 반환되는 값은 계산된 날짜의 처음을 나타냅니다.
DateTime 구조체는 모든 Date 값을 지원하므로 해당 메서드에는 Date 값을 어셈블하는 데 사용할 수 있는 추가 옵션이 있습니다. 예를 들어, 오버로드된 DateTime 생성자 중 하나를 사용하면 구성 요소를 필요한 대로 결합하여 Date 변수를 채울 수 있습니다. 다음 예제에서는 NewDateTime을 1978년 5월 6일 오전 8:30에서 0.1초 전의 시간으로 설정합니다.
Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
예제
다음 예제에서는 DateSerial 함수를 사용하여 지정된 년, 월, 일에 해당하는 날짜를 반환합니다.
Dim MyDate As Date
' MyDate contains the date for February 12, 1969.
MyDate = DateSerial(1969, 2, 12) ' Return a date.
요구 사항
네임스페이스: Microsoft.VisualBasic
**모듈:**DateAndTime
**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)