Função Str

Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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

Sintaxe

Str(number)

O argumento necessário number é 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 à esquerda é sempre reservado para o sinal de number. Se number for positiva, a cadeia de caracteres retornada conterá um espaço à esquerda e o sinal de adição estará implícito.

Use a Format função para converter valores numéricos que você deseja formatar como datas, horas, moedas ou outros formatos definidos pelo usuário. Ao contrário Strde , a Format função não inclui um espaço à esquerda para o sinal de number.

Observação

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

Exemplo de consulta

Expressão. Resultados
SELECT Discount, Str(Discount) AS StrDiscount FROM ProductSales; Retorna os valores originais Discount junto com os valores convertidos para o StrDiscount formato de cadeia de caracteres na coluna.

Exemplo de VBA

Observação

Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a Str função 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 à esquerda é 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".