FormatDateTime 함수(Visual Basic)

아티클
08/20/2008

업데이트: 2007년 11월

날짜/시간 값을 나타내는 문자열 식을 반환합니다.

Function FormatDateTime(
   ByVal Expression As DateTime,
   Optional ByVal NamedFormat As DateFormat = DateFormat.GeneralDate
) As String

매개 변수

Expression
필수적 요소. 형식을 지정할 Date 식입니다.
NamedFormat
선택적 요소. 사용되는 날짜/시간 형식을 나타내는 숫자 값입니다. 이 인수를 생략하면 DateFormat.GeneralDate가 사용됩니다.

설정

NamedFormat 인수 설정은 다음과 같습니다.

상수	설명
DateFormat.GeneralDate	날짜 및/또는 시간을 표시합니다. 날짜 부분을 간단한 날짜 형식으로 표시합니다. 시간 부분은 자세히 표시합니다. 날짜와 시간이 모두 있으면 둘 다 표시됩니다.
DateFormat.LongDate	시스템의 국가별 설정에 지정된 자세한 날짜 형식을 사용하여 날짜를 표시합니다.
DateFormat.ShortDate	시스템의 국가별 설정에 지정된 간단한 날짜 형식을 사용하여 날짜를 표시합니다.
DateFormat.LongTime	시스템의 국가별 설정에 지정된 시간 형식을 사용하여 시간을 표시합니다.
DateFormat.ShortTime	24시간 형식(hh:mm)을 사용하여 시간을 표시합니다.

예외

예외 형식	오류 번호	조건
ArgumentException	5	NamedFormat 설정이 잘못되었습니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

Date 데이터 형식에는 항상 날짜 정보와 시간 정보가 모두 포함됩니다. 형식 변환을 목적으로, Visual Basic은 1/1/1(1년 1월 1일)을 날짜의 기본값으로 간주하고 00:00:00(자정)을 시간의 기본값으로 간주합니다. Date 값을 날짜/시간 문자열 형식으로 변환할 경우 FormatDateTime의 결과 문자열에는 기본값이 포함되지 않습니다. 예를 들어, #1/1/0001 9:30:00#을 문자열로 변환한 결과는 "9:30:00 AM"이며 날짜 정보는 표시되지 않습니다. 그러나 날짜 정보는 원래 Date 값에 그대로 있으며 DatePart 등의 함수를 사용하여 복구할 수 있습니다.

참고:
Expression 인수를 String 리터럴로 전달하면 FormatDateTime은 응용 프로그램의 CurrentCulture 설정에 따라 리터럴을 해석합니다. 그러나 인수를 Date 리터럴로 전달할 경우 FormatDateTime은 항상 영어(미국) 문화권에 따라 Date 리터럴을 해석하므로 #mm/dd/yyyy# 형식을 사용합니다. 이것은 특정 문화권의 Date 리터럴을 사용하여 개발되고 코딩된 응용 프로그램을 다른 문화권이 사용되는 플랫폼에서 실행할 경우 Date 리터럴이 올바르지 않게 구문 분석될 수 있기 때문입니다.

Expression 인수를 String 리터럴로 전달하면 FormatDateTime은 응용 프로그램의 CurrentCulture 설정에 따라 리터럴을 해석합니다. 그러나 인수를 Date 리터럴로 전달할 경우 FormatDateTime은 항상 영어(미국) 문화권에 따라 Date 리터럴을 해석하므로 #mm/dd/yyyy# 형식을 사용합니다. 이것은 특정 문화권의 Date 리터럴을 사용하여 개발되고 코딩된 응용 프로그램을 다른 문화권이 사용되는 플랫폼에서 실행할 경우 Date 리터럴이 올바르지 않게 구문 분석될 수 있기 때문입니다.

예제

다음 예제에서는 FormatDateTime 함수의 사용법을 보여 줍니다.

' English (US) format.
Dim TestDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim TestString As String = FormatDateTime(TestDate, DateFormat.LongDate)