Função Str

  • Artigo

Retorna uma representação Variant (String) de um número.

Sintaxe

Str(número)

O argumentode número necessário é um Long que contém qualquer expressão numérica válida.

Comentários

Quando os números são convertidos em cadeias de caracteres, um espaço de liderança é sempre reservado para o sinal de número. Se o número for positivo, a cadeia de caracteres retornada conterá um espaço de liderança e o sinal de adição estará implícito.

Use a função Format para converter valores numéricos que você deseja formatar como datas, horários ou moeda ou em outros formatos definidos pelo usuário. Ao contrário do Str, a função Format não inclui um espaço de liderança para o sinal de número.

Observação

A função Str reconhece apenas o período ( . ) como um separador decimal válido. Quando separadores decimais diferentes podem ser usados (por exemplo, em aplicativos internacionais), use CStr para converter um número em uma cadeia de caracteres.

Exemplo

Este exemplo usa a função Str para retornar uma representação de cadeia de caracteres de um número. Quando um número é convertido em uma cadeia de caracteres, um espaço principal é sempre reservado para seu sinal.

Dim MyString
MyString = Str(459)    ' Returns " 459".
MyString = Str(-459.65)    ' Returns "-459.65".
MyString = Str(459.001)    ' Returns " 459.001".

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.