DateValue 함수(Visual Basic)
업데이트: 2007년 11월
시간 정보가 자정(00:00:00)으로 설정된 상태에서 문자열로 표시된 날짜 정보가 들어 있는 Date 값을 반환합니다.
Public Function DateValue(ByVal StringDate As String) As DateTime
매개 변수
- StringDate
필수적 요소. 1년 1월 1일 00:00:00부터 9999년 12월 31일 23:59:59까지의 날짜/시간 값을 나타내는 String 식입니다.
예외
예외 형식 |
오류 번호 |
조건 |
|---|---|---|
StringDate에 잘못된 날짜 정보가 들어 있습니다. |
비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.
설명
StringDate에 유효한 날짜 구분 기호로 구분된 1부터 12까지의 숫자만 포함된 경우 DateValue는 시스템에 지정된 간단한 날짜 형식에 따라 월, 일, 년의 순서를 인식합니다. DateValue는 System.Globalization 네임스페이스에 있는 CultureInfo 클래스의 CurrentCulture 속성의 현재 달력 설정을 사용합니다. 기본 CurrentCulture 값은 제어판의 설정에 따라 결정됩니다. System.Globalization 네임스페이스에 있는 DateTimeFormatInfo 클래스의 ShortDatePattern 속성을 설정하면 간단한 날짜 형식을 재정의할 수 있습니다.
DateValue는 긴 형식, 약식 형식 및 숫자 형식의 월 이름을 인식합니다. 예를 들어, DateValue는 12/30/1991과 12/30/91 외에 December 30, 1991과 Dec 30, 1991도 인식합니다.
StringDate의 연도 부분이 생략되면 DateValue는 컴퓨터의 시스템 날짜에 설정된 현재 연도를 사용합니다.
StringDate 인수에 시간 정보가 포함되면 DateValue는 반환되는 값에 이 정보를 포함하지 않습니다. 그러나 StringDate에 "89:98"과 같이 잘못된 시간 정보가 포함된 경우에는 InvalidCastException 오류가 발생합니다.
예제
다음 예제에서는 DateValue 함수를 사용하여 문자열을 날짜로 변환합니다. 날짜 리터럴을 사용하여 날짜를 Object 또는 Date 변수에 직접 할당할 수도 있습니다(예: oldDate = #2/12/69#).
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
요구 사항
네임스페이스:Microsoft.VisualBasic
**모듈:**DateAndTime
**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)