Format 함수

아티클
08/20/2008

업데이트: 2007년 11월

형식 String 식에 포함된 명령에 따라 형식 지정된 문자열을 반환합니다.

Public Shared Function Format( _
   ByVal Expression As Object, _
   Optional ByVal Style As String = "" _
) As String

매개 변수

Expression
필수적 요소. 임의의 유효한 식입니다.
Style
선택적 요소. 유효한 이름이 지정되거나 사용자 정의된 형식 String 식입니다.

설정

Style 인수를 만드는 방법에 대한 자세한 내용은 아래의 해당 항목을 참조하십시오.

형식 지정 대상	작업 방법
숫자	미리 정의된 숫자 형식을 사용하거나 사용자 정의 숫자 형식을 만듭니다.
날짜 및 시간	미리 정의된 날짜/시간 형식을 사용하거나 사용자 정의 날짜/시간 형식을 만듭니다.
날짜 및 시간 일련 번호	날짜 및 시간 형식 또는 숫자 형식을 사용합니다.

Style을 지정하지 않고 숫자의 형식을 지정하는 경우 국가별로 인식되긴 하지만 Format 함수는 Str 함수와 유사한 기능을 제공합니다. 그러나 Format 함수를 사용하여 문자열 형식이 지정된 양수에는 해당 값의 부호용으로 예약된 선행 공백이 없지만 Str 함수를 사용하여 변환된 양수에는 선행 공백이 있습니다.

설명

지역화되지 않은 숫자 문자열의 형식을 지정하는 경우 사용자 정의 숫자 형식을 사용하여 원하는 형식으로 지정되도록 해야 합니다.

String.Format 메서드도 유사한 기능을 제공합니다.

예제

다음 예제에서는 String 형식과 사용자 정의 형식을 모두 사용하여 값의 형식을 지정하는 Format 함수의 다양한 사용 방법을 보여 줍니다. 날짜 구분 기호(/), 시간 구분 기호(:), AM/PM 표시기(t 및 tt)의 경우 시스템에 실제로 표시되는 출력 형식은 코드에서 사용하는 로캘 설정에 따라 달라집니다. 개발 환경에 시간과 날짜가 표시되는 경우 코드 로캘의 간단한 시간 형식과 날짜 형식이 사용됩니다.

참고:
24시간 형식을 사용하는 로캘의 경우에는 AM/PM 표시기(t와 tt)에 아무것도 표시되지 않습니다.

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")