Home
Search
 
What's New
Index
Books
Links
Q & A
Newsletter
Banners
 
Feedback
Tip Jar
 
C# Helper...
 
XML RSS Feed
Follow VBHelper on Twitter
 
 
 
MSDN Visual Basic Community
 
 
 
 
 
TitleUse the FormatPercent function in Visual Basic 6
DescriptionThis example shows how to use the FormatPercent function in Visual Basic 6.
KeywordsFormatPercent, format percent
CategoriesStrings
 
The FormatPercent function returns a formatted string representation for a number representing a percentage. It is very similar to FormatNumber except it multiplies the number by 100 and adds a percent character to the result. The syntax is:

    FormatPercent(expression _
        [, digits_after_decimal] _
        [, include_leading_zero] _
        [, use_parens_if_negative] _
        [, groups_digits] )

Where:

expression
The numeric expression to format

digits_after_decimal
The number of digits to display after the decimal point

include_leading_zero
If the number is less than 1 and greater than -1, determines whether the number should have a leading 0 before the decimal point.

use_parens_if_negative
Determines whether negative numbers are surrounded with parentheses instead of using a minus sign.

groups_digits
Determines whether digits to the left of the decimal point are grouped with thousands separators (commas in the United States).

Examples (in the United States):

ExpressionResult
FormatPercent(1.23456, 2)123.46%
FormatPercent(0.001234, 2, TriState.False)0.12%
FormatPercent(0.001234, 2, TriState.True).12%
FormatPercent(-12345.12, , TriState.False)-1,234,512.00%
FormatPercent(-12345.12, , TriState.True)(1,234,512.00%)
FormatPercent(-12345.12, , TriState.True, TriState.False)(1234512.00%)

This example uses the following code to display these examples in a TextBox.

 
Private Sub Form_Load()
    Dim txt As String
    Dim x As Single

    txt = ""
    x = 1.23456
    txt = txt & "FormatPercent(" & Format$(x) & ", 2) = " & _
        FormatPercent(x, 2) & vbCrLf

    x = 0.001234
    txt = txt & "FormatPercent(" & Format$(x) & ", 2, " & _
        "vbFalse) = " & FormatPercent(x, 2, vbFalse) & _
        vbCrLf
    txt = txt & "FormatPercent(" & Format$(x) & ", 2, " & _
        "vbTrue) = " & FormatPercent(x, 2, vbTrue) & vbCrLf

    x = -12345.12345
    txt = txt & "FormatPercent(" & Format$(x) & ", , " & _
        "vbFalse) = " & FormatPercent(x, 2, , vbFalse) & _
        vbCrLf
    txt = txt & "FormatPercent(" & Format$(x) & ", , " & _
        "vbTrue) = " & FormatPercent(x, 2, , vbTrue) & _
        vbCrLf
    txt = txt & "FormatPercent(" & Format$(x) & ", , " & _
        "vbTrue, vbFalse) = " & FormatPercent(x, 2, , _
        vbTrue, vbFalse) & vbCrLf

    txtResults.Text = txt
End Sub
 
 
Copyright © 1997-2006 Rocky Mountain Computer Consulting, Inc.   All rights reserved.
  Updated