Повертає вираз, відформатований як значення грошової одиниці з використанням символу грошової одиниці, визначеного на Панелі керування системи.
Синтаксис
FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
Синтаксис функції FormatCurrency має такі аргументи:
| Аргумент | Опис |
|---|---|
| Вираз | Обов’язковий аргумент. Вираз, який потрібно відформатувати. |
| NumDigitsAfterDecimal | Необов’язковий аргумент. Числове значення, яке вказує кількість розрядів, що мають відображатися праворуч від десяткової коми. Стандартне значення становить –1 і означає, що використовуються регіональні параметри комп’ютера. |
| IncludeLeadingDigit | — необов’язковий аргумент. Константа TriState, яка визначає, чи для дробових значень відображається нуль на початку. Значення див. в розділі "Параметри". |
| UseParensForNegativeNumbers | — необов’язковий аргумент. Константа TriState, яка визначає, чи брати від'ємні значення в дужки. Значення див. в розділі "Параметри". |
| GroupDigits | — необов’язковий аргумент. Константа TriState, яка вказує на те, чи числа згруповано за допомогою роздільника групи, указаного в регіональних параметрах комп'ютера. Значення див. в розділі "Параметри". |
Параметри
Аргументи IncludeLeadingDigit, UseParensForNegativeNumbers і GroupDigits мають такі параметри:
| Константа | Значення | Опис |
|---|---|---|
| vbTrue | –1 | Істина |
| vbFalse | 0 | Хибність |
| vbUseDefault | –2 | Використовуйте параметр із регіональних параметрів комп’ютера. |
Примітки
Якщо опущено один або кілька необов’язкових аргументів, значення для них беруться з регіональних параметрів комп’ютера.
Положення символу грошової одиниці відносно значення грошової одиниці визначено в регіональних параметрах системи.
Примітка.
Усі параметри беруться з вкладки Regional Settings Currency, окрім параметра використання нуля на початку, який береться з вкладки Number.
Приклади
| Вираз | Результати. |
|---|---|
| SELECT FormatCurrency([Ціна за одиницю]), AS вираз1 FROM ProductSales; | Форматує числові значення в полі "Ціна_за_одиницю" у форматі "Грошова одиниця" та повертає результат у стовпці Вираз1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Форматує числові значення в полі "Знижка" у формат "Грошова одиниця" з 2 десятковими комами, у всіх менших за 1 значення перед десятковою комою буде "0", від'ємні значення буде взято в дужки, значення буде згруповано за замовчуванням роздільником ("1000" відображатиметься як 1000,00 грн, "-1000" буде відображено як (1000,00 грн), "0" буде відображено як 0,00 грн). |