Returnerer en streng med talformatering anvendt på et numerisk udtryk. Et procenttegn er tilføjet i den returnerede streng.
Denne konstant, funktion eller objekt blev aktiveret med udtrykket Option VBASupport 1 placeret foran den del af modulets programkode, der kan udføres.
Syntaks:
FormatPercent( expression, [numDigitsAfterDecimal As Integer], [includeLeadingDigit As Integer], _
[useParensForNegativeNumbers As Integer], [groupDigits As Integer] ) As String
Returværdi:
String
Parametre:
expression: Obligatorisk. Et numerisk udtryk som skal formateres. Hvis expression er en streng, så skal eventuelle decimaltegn og tusindtalsskilletegn følge lokaliseringsindtillingerne (på dansk: "," som komma og "." til at skille mellem tusinder).
numDigitsAfterDecimal: Valgfri. En numerisk værdi, der bestemmer antallet af cifre, som skal vises efter decimaltegnet. Hvis udeladt, er standardværdien -1, det vil sige, at brugerfladens landeindstillinger skal bruges.
includeLeadingDigit: Valgfri. En vbTriState optællingsværdi, der bestemmer om et foranstillet nul skal vises ved brøkværdier.
vbTrue eller -1: Vis et foranstillet nul.
vbFalse eller 0: Vis ikke foranstillede nuller.
vbUseDefault eller -2: Brug de lokalitetsindstillingerne fra brugerfladen. Hvis parameteren udelades, er dette standard.
useParensForNegativeNumbers: Valgfri. En vbTriState optællingsværdi, der bestemmer, om negative tal skal indesluttes i parenteser.
vbTrue eller -1: Anvend parenteser ved negative tal.
vbFalse ellerr 0: Vis ikke parenteser.
vbUseDefault eller -2: Samme som vbFalse. Hvis parameteren udelades, er dette standard.
groupDigits: Valgfri. En vbTriState optællingsværdi, der bestemmer, om tallet skal grupperes (i tusinder osv.) med den gruppeopdeler, der er bestemt i systemets landeindstillinger.
vbTrue eller -1: Grupper cifre.
vbFalse eller 0: Grupper ikke cifre.
vbUseDefault eller -2: Samme som vbFalse. Hvis parameteren udelades, er dette standard.
Fejlkoder:
13 Datatypen passer ikke
Eksempel:
Sub TestFormatNumber
Const UseComputerRegionalSettings = -1
MsgBox FormatPercent(12.2, NumDigitsAfterDecimal:=2) ' 1220.00% hvis den valgte brugerflade er engelsk
MsgBox FormatPercent("-,2", 2, IncludeLeadingDigit:=vbTrue) ' -20,00% hvis brugerfladen er fransk
MsgBox FormatPercent("-0.2", 2) ' -20.00% for en-US, -0,00 for fr-CA, de-AT eller pt-BR
MsgBox FormatPercent(-0.2, UseComputerRegionalSettings, UseParensForNegativeNumbers:=vbTrue) ' (20,00)% hvis pt-BR
MsgBox FormatPercent("-0,2", UseComputerRegionalSettings, vbUseDefault, vbTrue) ' (20,00)% hvis tysk
MsgBox FormatPercent("-12345678", -1, vbUseDefault, vbUseDefault, GroupDigits:=vbTrue) ' -1 234 567 800,00% for fr-BE
End Sub
