Zwraca wyrażenie sformatowane jako wartość walutowa przy użyciu symbolu waluty zdefiniowanego w systemowym panelu sterowania.
Składnia
FormatCurrency(wyrażenie [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
W składni funkcji FormatWaluta występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| Wyrażenie | Argument wymagany. Wyrażenie do sformatowania. |
| NumDigitsAfterDecimal | Argument opcjonalny. Wartość liczbowa wskazująca, ile miejsc po prawej stronie przecinka jest wyświetlanych. Wartość domyślna to -1, co oznacza, że używane są ustawienia regionalne komputera. |
| IncludeLeadingDigit (UwzględnijCyfrę wiodącą) | Argument opcjonalny. Stała trójstanowa wskazująca, czy dla wartości ułamkowych jest wyświetlane zero wiodące. Wartości można znaleźć w sekcji Ustawienia. |
| UseParensForNegativeNumbers | Argument opcjonalny. Stała trójstanowa wskazująca, czy wartości ujemne mają być umieszczane w nawiasach. Wartości można znaleźć w sekcji Ustawienia. |
| GroupDigits (Cyfry grupowania) | Argument opcjonalny. Stała trójstanowa wskazująca, czy liczby są grupowane przy użyciu ogranicznika grupy określonego w ustawieniach regionalnych komputera. Wartości można znaleźć w sekcji Ustawienia. |
Ustawienia
Argumenty IncludeLeadingDigit, UseParensForNegativeNumbers i GroupDigits mają następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbTrue (Prawda języka vb) | –1 | Prawda |
| vbFalse (fałsz) | 0 | Fałsz |
| vbUseDefault | –2 | Użyj ustawienia z ustawień regionalnych komputera. |
Uwagi
Jeśli co najmniej jeden argument opcjonalny zostanie pominięty, wartości dla pominiętych argumentów zostaną określone w ustawieniach regionalnych komputera.
Położenie symbolu waluty względem wartości waluty zależy od ustawień regionalnych systemu.
Uwaga
Wszystkie informacje o ustawieniach pochodzą z karty Ustawienia regionalne Waluta , z wyjątkiem zera wiodącego, które pochodzi z karty Liczby .
Przykłady
| Wyrażenie | Rezultat |
|---|---|
| SELECT FormatCurrency([CenaJednostkowa]) AS Wyr1 FROM SprzedażProduktów; | Formatuje wartości liczbowe w polu "CenaJednostkowa" do formatu "Waluta" i zwraca wartość w kolumnie Wyr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Formatuje wartości liczbowe w polu "Discount" do formatu "Currency" z dwoma miejscami dziesiętnymi. Wszystkie wartości mniejsze niż 1 będą miały "0" przed przecinkiem dziesiętnym, wartości ujemne zostaną ujęte w nawiasy, wartości zostaną pogrupowane według domyślnego ogranicznika ("1000" będzie wyświetlane jako 1000,00 zł, "-1000" będzie wyświetlane jako (1000,00 zł), "0" będzie wyświetlane jako 0,00 zł). |