Função Str

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

Devolve 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, um espaço à esquerda é sempre reservado para o sinal de number. Se number for positivo, a cadeia devolvida contém um espaço à esquerda e o sinal de adição está implícito.

Utilize a Format função para converter valores numéricos que pretende formatar como datas, horas, moeda ou outros formatos definidos pelo utilizador. 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 período (.) como um separador decimal válido. Quando podem ser utilizados diferentes separadores decimais, como em aplicações internacionais, utilize CStr para converter um número numa cadeia.

Exemplo de consulta

Expressão. Resultados
SELECT Discount, Str(Discount) AS StrDiscount FROM ProductSales; Devolve os valores originais Discount juntamente com os valores convertidos em formato de cadeia na StrDiscount coluna.

Exemplo de VBA

Observação

Exemplos que se seguem demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Programador na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a Str função para devolver uma representação de cadeia de carateres de um número. Quando um número é convertido numa cadeia, um espaço à esquerda é sempre reservado para o respetivo sinal.

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