Como usar a função vba formatpercent?

A função VBA FORMATPERCENT está listada na categoria de conversão de tipo de dados das funções VBA. Quando você o usa no código VBA, ele retorna a expressão fornecida aplicando um formato de porcentagem a ela . Em palavras simples, ele retorna o resultado com formato percentual como tipo de dados string.

Sintaxe

FormatPercent(Expressão, [NumDigitsAfterDecimal], [IncludeLeadingDigit],[UseParensForNegativeNumbers], [GroupDigits])

Argumentos

• Expressão : A expressão que você deseja formatar.
• [ NumDigitsAfterDecimal] : Um valor numérico para especificar casas decimais [Este é um argumento opcional e, se omitido, -1 é o padrão].
• [IncludeLeadingDigit] : Um valor de enumeração para especificar se um zero à esquerda deve ser exibido [Este é um argumento opcional e, se omitido, o VBA usará vbUseDefault por padrão].
  • vbFalse: não deve ser precedido de zero.
  • vbTrue: exibe um zero à esquerda.
  • vbUseDefault: usa configurações padrão.
• [UseParensForNegativeNumbers] : Um valor de enumeração para especificar se números negativos devem ser colocados entre parênteses [Este é um argumento opcional e se omitido, o VBA usará vbUseDefault por padrão].
  • vbFalse: para não colocar números negativos entre parênteses.
  • vbTrue: coloque números negativos entre parênteses.
  • vbUseDefault: usa configurações padrão.
• [GroupDigits] : Um valor de enumeração para especificar se o número deve ser agrupado (em milhares, etc.), usando o delimitador de grupo especificado na localidade do computador [Este é um argumento opcional e se for omitido, o VBA usará vbUseDefault por padrão ].
  • vbFalse: para não usar os números do grupo.
  • vbTrue: para usar os números do grupo.
  • vbUseDefault: Usa as configurações padrão do computador.

Exemplo

Para entender de forma prática como usar a função VBA FORMATPERCENT, você precisa seguir o exemplo abaixo, onde escrevemos um código VBA usando-a:

 Sub example_FORMATPERCENT() Range("B1").Value = FormatPercent(Range("A1")) End Sub

No código acima, usamos FORMATPERCENT para converter o valor da célula A1 em porcentagem e retornamos o resultado na célula B1.

Comentários

• Se o valor especificado for diferente de um número ou string que não pode ser reconhecido como um número, o VBA retornará o erro de tempo de execução 13.