Pular para o conteúdo principal
Roberty Studio
RPAFunções

Converter para número

Converter para número

Converte um valor de texto para o tipo numérico, com suporte a diferentes formas de tratamento da parte decimal. Ideal para situações em que um valor foi capturado como texto — por exemplo, a partir de uma planilha ou de uma página web — e precisa ser usado em cálculos.


Opções​

Valor, texto ou variável​

Informe o valor de texto que será convertido para número. Pode ser um texto fixo, um número, o retorno de outra ação, uma variável ou um parâmetro.

Separador da Fração​

Selecione o caractere que separa a parte inteira da parte decimal: Vírgula ou Ponto. Por exemplo, com Vírgula, o valor "1.234,56" se torna 1234.56.

Quantidade de Frações​

Informe quantos dos últimos dígitos do valor devem ser tratados como casas decimais. Por exemplo, com 2, o valor "1234" se torna 12.34. Este campo só é considerado quando nenhum Separador da Fração estiver selecionado.

Retornos​

Código Javascript​

js
actions["id-da-acao"].number // valor convertido para número (Número)

Seleção de campos​

  • number — valor numérico resultante da conversão (Número)

Regras e Condições​

  • O campo Valor, texto ou variável é obrigatório.
  • Todos os caracteres que não são dígitos são descartados antes da conversão — inclusive o sinal de negativo.
  • Quando o Separador da Fração é informado, ele tem prioridade sobre a Quantidade de Frações.
  • Sem Separador da Fração e sem Quantidade de Frações, o resultado é um número inteiro formado por todos os dígitos do valor (por exemplo, "12,34" se torna 1234).
  • Se o valor já for um número, ele é retornado sem alterações.