Gibt einen als Prozentsatz formatierten Ausdruck (multipliziert mit 100) mit einem nachfolgenden Prozentzeichen (%) zurück.
Syntax
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
Die Syntax der Funktion FormatPercent 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.
Hinweis
Alle Informationen zu den Einstellungen werden der Registerkarte Regional Settings Number entnommen.
Beispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; | Formatiert die Werte im Feld "DPercent" in das Format "Percent" und gibt in spalte Expr1 zurück. |
| SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; | Formatiert die Werte im Feld "DPercent" in das Format "Prozent" mit 2 Dezimalstellen, alle Werte unter 1 % haben vor dem Dezimaltrennzeichen "0", negative Werte werden in Klammern abgedeckt, der Wert wird nach dem Standardtrennzeichen gruppiert ("10" wird als 1.000,00 % angezeigt, "-10" wird als (1.000,00 %), "0" wird als 0,00 % angezeigt. |