Funções FormatNumber

Retorna uma expressão formatada como um número.

Sintaxe

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

Argumentos:

  • Expression: Obrigatório. Expressão a ser formatada.
  • NumDigitsAfterDecimal: Opcional. Valor numérico que indica quantas casas à direita do decimal são exibidas. O valor padrão é -1, que indica o uso das configurações regionais do computador.
  • IncludeLeadingDigit: Opcional. Constante que indica se um zero à esquerda é exibido para valores fracionais. Consulte a seção Configurações para ver os valores.
  • UseParensForNegativeNumbers: Opcional. Constante que indica se valores negativos devem ser colocados entre parênteses. Consulte a seção Configurações para ver os valores.
  • GroupDigits: Opcional. Constante que indica se os números devem ser agrupados usando o delimitador de grupo especificado no painel de controle. Consulte a seção Configurações para ver os valores.

Configurações: Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers e GroupDigits têm as seguintes configurações:

Tabela 11-12 Configurações: Função FormatNumber

Valor Descrição
-1 True
0 False
-2 Use a configuração das configurações regionais do computador.

Comentários:

Quando um ou mais argumentos opcionais são omitidos, os valores dos argumentos omitidos são fornecidos pelas configurações regionais do computador.

Nota:

Todas as informações de configurações vêm da guia Número das Configurações Regionais.

Os exemplos a seguir mostram o uso da função FormatNumber e a saída esperada:

Dim formattedNum
formattedNum = FormatNumber(20000)
'formattedNum Outputs: 20,000.00
formattedNum = FormatNumber(20000,2)
'formattedNum Outputs: 20,000.00
formattedNum = FormatNumber(20000,5)
'formattedNum Outputs: 20,000.00000
formattedNum = FormatNumber(.20) 
'formattedNum Outputs: 0.20
formattedNum = FormatNumber(.20,2,0)    
'formattedNum Outputs: .20
formattedNum = FormatNumber(.20,2,-1) 
'formattedNum Outputs: 0.20
formattedNum = FormatNumber(-50) 
'formattedNum Outputs: -50.00
formattedNum = FormatNumber(-50,1,-1,0) 
'formattedNum Outputs: -50.0
formattedNum = FormatNumber(-50,1,-1,-1) 
'formattedNum Outputs: (50.0)
formattedNum = FormatNumber(10000000) 
'formattedNum Outputs: 10,000,000.00
formattedNum = FormatNumber(10000000,1,-1,-1,0) 
'formattedNum Outputs: 10000000.0
formattedNum = FormatNumber(10000000,1,-1,-1,-1) 
'formattedNum Outputs: 10,000,000.0