FormatCurrency 함수(Visual Basic)

아티클
08/20/2008

업데이트: 2007년 11월

시스템 제어판에 정의된 통화 기호를 사용하여 통화 값으로 서식이 지정된 식을 반환합니다.

Function FormatCurrency(
   ByVal Expression As Object,
   Optional ByVal NumDigitsAfterDecimal As Integer = -1,
   Optional ByVal IncludeLeadingDigit As TriState = TriState.UseDefault,
   Optional ByVal UseParensForNegativeNumbers As TriState = TriState.UseDefault,
   Optional ByVal GroupDigits As TriState = TriState.UseDefault
) As String

매개 변수

Expression
필수적 요소. 서식을 지정할 식입니다.
NumDigitsAfterDecimal
선택적 요소. 소수점 오른쪽에 표시할 자릿수를 나타내는 숫자 값입니다. 기본값은 -1로, 시스템의 국가별 설정 값이 사용됨을 나타냅니다.
IncludeLeadingDigit
선택적 요소. 소수 값에서 앞에 오는 0을 표시할지 여부를 나타내는 TriState 열거형입니다. 값에 대해서는 "설정"을 참조하십시오.
UseParensForNegativeNumbers
선택적 요소. 음수를 괄호로 묶을지 여부를 나타내는 TriState 열거형입니다. 값에 대해서는 "설정"을 참조하십시오.
GroupDigits
선택적 요소. 컴퓨터의 국가별 설정에 지정된 그룹 구분 기호를 사용하여 숫자를 그룹화할지 여부를 나타내는 TriState 열거형입니다. 값에 대해서는 "설정"을 참조하십시오.

설정

IncludeLeadingDigit, UseParensForNegativeNumbers 및 GroupDigits 인수는 다음 TriState 열거형 값을 사용합니다.

값	설명
TriState.True	True
TriState.False	False
TriState.UseDefault	시스템의 국가별 설정

예외

예외 형식	오류 번호	조건
ArgumentException	5	소수점 이하 자릿수가 99보다 큽니다.
InvalidCastException	13	숫자 형식이 아닙니다.

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

설명

하나 이상의 선택적 인수가 생략될 경우 그 대신 일치하는 시스템의 국가별 설정 값이 사용됩니다.

통화 값에 상대적인 통화 기호의 위치는 시스템의 국가별 설정 값에 의해 결정됩니다.

참고:
모든 설정 정보는 응용 프로그램의 로캘에서 가져오며, 기본적으로는 제어판에 설정된 로캘이 사용됩니다. 그러나 Number 탭을 선택할 때 앞에 오는 0을 제외하고 .NET Framework를 사용하여 프로그래밍 방식으로 이 설정을 변경할 수 있습니다.

예제

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

Dim TestDebt As Double = -4456.43
Dim TestString As String
' Returns "($4,456.43)".
TestString = FormatCurrency(TestDebt, , , TriState.True, TriState.True)