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