Number.ToTextNumber.ToText

SintaxeSyntax

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

SobreAbout

Formata o valor numérico number em um valor de texto de acordo com o formato especificado por format.Formats the numeric value number to a text value according to the format specified by format. O formato é um código de caractere único, opcionalmente seguido por um especificador de precisão de número.The format is a single character code optionally followed by a number precision specifier. Os códigos de caracteres a seguir podem ser usados para format.The following character codes may be used for format.

  • "D" ou "d": (Decimal) Formata o resultado como dígitos inteiros."D" or "d": (Decimal) Formats the result as integer digits. O especificador de precisão controla o número de dígitos na saída.The precision specifier controls the number of digits in the output.
  • "E" ou "e": (Exponencial/científico) Notação exponencial."E" or "e": (Exponential/scientific) Exponential notation. O especificador de precisão controla o número máximo de dígitos decimais (o padrão é 6).The precision specifier controls the maximum number of decimal digits (default is 6).
  • "F" ou "f": (Ponto fixo) Dígitos inteiros e decimais."F" or "f": (Fixed-point) Integral and decimal digits.
  • "G" ou "g": (Geral) A forma mais compacta de um ponto fixo ou científico."G" or "g": (General) Most compact form of either fixed-point or scientific.
  • "N" ou "n": (Número) Dígitos inteiros e decimais com separadores de grupo e um separador decimal."N" or "n": (Number) Integral and decimal digits with group separators and a decimal separator.
  • "P" ou "p": (Percentual) Número multiplicado por 100 e exibido com um símbolo de porcentagem."P" or "p": (Percent) Number multiplied by 100 and displayed with a percent symbol.
  • "R" ou "r": (Viagem de ida e volta) Um valor de texto que pode fazer uma viagem de ida e volta de um número idêntico."R" or "r": (Round-trip) A text value that can round-trip an identical number. O especificador de precisão é ignorado.The precision specifier is ignored.
  • "X" ou "x": (Hexadecimal) Um valor de texto hexadecimal."X" or "x": (Hexadecimal) A hexadecimal text value.
Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").An optional culture may also be provided (for example, "en-US").

Exemplo 1Example 1

Formatar um número como texto sem formato especificado.Format a number as text without format specified.

Number.ToText(4)

"4"

Exemplo 2Example 2

Formatar um número como texto em formato Exponencial.Format a number as text in Exponential format.

Number.ToText(4, "e")

"4.000000e+000"

Exemplo 3Example 3

Formatar um número como texto em formato Decimal com precisão limitada.Format a number as text in Decimal format with limited precision.

Number.ToText(-0.1234, "P1")

"-12.3 %"