式の値に 100 を掛けて末尾に % 文字を付け、パーセンテージとして書式設定して返します。
構文
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
FormatPercent 関数構文の引数は次のとおりです。
| 引数 | 説明 |
|---|---|
| 式 | 必須。 書式設定する式です。 |
| NumDigitsAfterDecimal | 省略可能。 小数点の右側に表示される桁数を示す数値です。 既定値は –1 で、コンピューターの地域設定が使われることを意味します。 |
| IncludeLeadingDigit | 省略可能。 小数値の前に 0 を表示するかどうかを指定する tristate 定数です。 値については、「設定」セクションを参照してください。 |
| UseParensForNegativeNumbers | 省略可能。 かっこ内の数値を負の値として扱うかどうかを指定する tristate 定数です。 値については、「設定」セクションを参照してください。 |
| GroupDigits | 省略可能。 コンピューターの地域設定で指定されている桁区切り文字を使って数値の桁を区切るかどうかを指定する tristate 定数です。 値については、「設定」セクションを参照してください。 |
設定
IncludeLeadingDigit、UseParensForNegativeNumbers、および GroupDigits 引数には、次の設定があります。
| 定数 | 値 | 説明 |
|---|---|---|
| vbTrue | –1 | True |
| vbFalse | 0 | False |
| vbUseDefault | –2 | コンピューターの地域設定の設定を使います。 |
解説
省略可能な引数を省略すると、省略した引数の値はコンピューターの地域設定から提供されます。
注
すべての設定情報は、地域の設定の [数値] タブから取得されます。
例
| Expression | 結果 |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; | "DPercent" フィールドの値を "Percent" 形式に書式設定し、列 Expr1 で返します。 |
| SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; | "DPercent" フィールドの値を小数点以下 2 桁の "パーセント" 形式に書式設定します。 1% 未満の値はすべて 10 進の前に "0" になり、負の値はかっこで囲まれます。値は既定の区切り記号でグループ化されます ("10" は 1,000.00% として表示されます。"-10" は (1,000.00%)、"0" は 0.00% として表示されます。 |