Возвращает выражение в формате процента (т. е. с коэффициентом 100), в конец которого добавлен знак %.
Синтаксис
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
Функция FormatPercent имеет следующие аргументы:
| Аргумент | Описание |
|---|---|
| Выражение | Обязательный аргумент. Выражение, которое нужно отформатировать. |
| знаки_после_разделителя | Необязательный аргумент. Числовое значение, которое указывает число разрядов, отображаемых после запятой в десятичном числе. Значением по умолчанию является -1 (использование региональных параметров компьютера). |
| отображение_незначащих_нулей | Необязательный аргумент. Константа с тремя значениями, которая показывает, отображаются ли нули в начале дробных значений. Возможные значения см. в разделе "Параметры". |
| скобки_отрицательного_числа | Необязательный аргумент. Константа с тремя значениями, которая показывает, заключаются ли отрицательные значения в круглые скобки. Возможные значения см. в разделе "Параметры". |
| группировка | Необязательный аргумент. Константа с тремя значениями, которая показывает, группируются ли числа при помощи разделителя, заданного в региональных параметрах компьютера. Возможные значения см. в разделе "Параметры". |
Параметры
Аргументы IncludeLeadingDigit, UseParensForNegativeNumbers и GroupDigits имеют следующие параметры:
| Константа | Значение | Описание |
|---|---|---|
| vbTrue | –1 | Истина |
| vbFalse | 0 | Ложь |
| vbUseDefault | –2 | Используется значение из региональных параметров компьютера. |
Замечания
Для пропущенных необязательных аргументов используются значения из региональных параметров компьютера.
Примечание
Все сведения о параметрах поступают с вкладки Число в окне региональных параметров.
Примеры
| Выражение | Результаты |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; | Форматирует значения в поле "DPercent" в формат "Процент" и возвращает значение в столбце Expr1. |
| SELECT FormatPercent([DPercent],2;-1;-1;-1) AS DPercentage FROM ProductSales; | Форматирует значения в поле "DPercent" в формат "Процент" с 2 десятичными точками, все значения меньше 1 % будут иметь значение "0" до десятичной дроби, отрицательные значения будут покрываться в круглые скобки, значение будет сгруппировано по разделителю по умолчанию ("10" будет отображаться как 1000,00%, "-10" будет отображаться как (1000,00%), "0" будет отображаться как 0,00%. |