FormatCurrency-Funktion (FormatWährung)

Gilt für
Access für Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Gibt einen als Währungswert formatierten Ausdruck unter Verwendung des in der Systemsteuerung des Systems definierten Währungssymbols zurück.

Syntax

FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )

Die Syntax der Funktion FormatCurrency weist die folgenden Argumente auf:

Argument Beschreibung
Ausdruck Erforderlich. Der zu formatierende Ausdruck.
AnzStellenNachDezimal Optional. Numerischer Wert, der angibt, wie viele Stellen rechts vom Dezimaltrennzeichen angezeigt werden. Der Standardwert (–1) bedeutet, dass die Landes-/Regionaleinstellungen des Computers verwendet werden.
FührendeStelleAnzeigen Optional. Eine von drei Konstanten, die angibt, ob für Bruchwerte eine führende Null angezeigt werden soll oder nicht. Die erforderlichen Werte finden Sie im Abschnitt "Einstellungen".
KlammernFürNegativeZahlen Optional. Eine von drei Konstanten, die angibt, ob negative Werte in Klammern gesetzt werden oder nicht. Die erforderlichen Werte finden Sie im Abschnitt "Einstellungen".
StellenGruppieren Optional. Eine von drei Konstanten, die angibt, ob Zahlen mit dem Gruppentrennzeichen gruppiert werden, das in den Landes-/Regionaleinstellungen des Computers angegeben ist. Die erforderlichen Werte finden Sie im Abschnitt "Einstellungen".

    

Einstellungen

Die Argumente IncludeLeadingDigit, UseParensForNegativeNumbers und GroupDigits weisen die folgenden Einstellungen auf:

Konstante Wert Beschreibung
vbTrue –1 True
vbFalse 0 False
vbUseDefault –2 Die Landes-/Regionaleinstellungen des Computers werden verwendet.

    

Hinweise

Werden optionale Argumente ausgelassen, werden die Werte für die ausgelassenen Argumente durch die Landes-/Regionaleinstellungen des Computers bereitgestellt.

Die Position des Währungssymbols relativ zum Währungswert wird durch die Landes-/Regionaleinstellungen des Systems bestimmt.

Hinweis

Alle Informationen zu den Einstellungen werden der Registerkarte Regional Settings Currency entnommen, mit Ausnahme der Einstellung für die führende Null, die der Registerkarte Number entnommen wird.

Beispiele

Ausdruck Ergebnisse
SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; Formatiert die Zahlenwerte im Feld "UnitPrice" in das Format "Currency" und gibt in Spalte Expr1 zurück.
SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; Formatiert die Zahlenwerte im Feld "Rabatt" in das Format "Währung" mit 2 Dezimalstellen, alle Weniger als 1 Werte haben "0" vor dem Dezimaltrennzeichen, negative Werte werden in Klammern abgedeckt. Der Wert wird als Standardtrennzeichen gruppiert ("1000" wird als $1.000.00 angezeigt, "-1000" wird als ($1.000,00) und "0" als $0.00 angezeigt).