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