Compartilhar via


Number.ToText

Sintaxe

Number.ToText(
    number as nullable number,
    optional format as nullable text,
    optional culture as nullable text
) as nullable text

Sobre

Converte o valor number numérico em um valor de texto de acordo com o formato especificado por format.

O formato é um valor de texto que indica como o número deve ser convertido. Para obter mais detalhes sobre os valores de formato com suporte, vá para cadeias de caracteres de formato numérico Standard e cadeias de caracteres de formato numérico personalizado.

Um opcional culture também pode ser fornecido (por exemplo, "en-US") para controlar o comportamento dependente da cultura de format.

Exemplo 1

Converta um número em texto sem especificar um formato.

Usage

Number.ToText(4)

Saída

"4"

Exemplo 2

Converter um número em formato exponencial.

Usage

Number.ToText(4, "e")

Saída

"4.000000e+000"

Exemplo 3

Converta um número em formato de porcentagem com apenas um local decimal.

Usage

Number.ToText(-0.1234, "P1")

Saída

"-12.3 %"