Guia de scripting do ACL versão 14.1

Função STRING( )

Converte um valor numérico em uma sequência de caracteres.

STRING(número; comprimento <;formato>)
Nome Tipo Descrição
número

numérico

O valor numérico a ser convertido em uma cadeia.

comprimento numérico

O número de caracteres na cadeia de saída.

formato

opcional

caractere A formatação a ser aplicada à cadeia de saída. Por exemplo, "(9.999,99)"

Caractere.

Exemplos básicos

Cadeias não formatadas

Retorna " 125,2":

STRING(125,2; 6)

Retorna "25,2" (-1 é truncado, porque o comprimento é menor do que o número de dígitos e caracteres de formatação em número):

STRING(-125,2; 4)

Retorna " -125,2":

STRING(-125,2; 7)

Cadeias formatadas

Retorna "  (125,20)":

STRING(-125,2; 10;  "(9.999,99)")

Retorna "25,20" (1 é truncado, porque o comprimento é menor do que o número de dígitos e caracteres de formatação em número):

STRING(125,2; 6;  "(9.999,99)")

Entrada de campo

Retorna valores numéricos do campo Número_Funcionário como cadeias de caracteres com um comprimento de 10 caracteres. Se necessário, o valor de retorno é completado ou truncado:

STRING(Número_Funcionário, 10)

Valores de retorno preenchidos e truncados

STRING( ) converte o número em uma cadeia de caracteres de comprimento especificada em comprimento:

  • Se o número for mais curto que comprimento, espaços à esquerda serão adicionados ao valor retornado
  • Se o número for mais longo do que o comprimento, o valor retornado será truncado do lado esquerdo

Formatação do valor de retorno

O parâmetro opcional formato adiciona formatação ao valor retornado, como símbolos de dólar, símbolos de porcentagem, decimais, vírgulas, indicadores negativos ou parênteses. O formato deve estar entre aspas.

O dígito 9 atua como um espaço reservado para dígitos a serem formatados. Certifique-se de que você tem o número certo de 9s para a exibição correta. Você também precisa contar com decimais e caracteres de formatação, como símbolos de dólar e colchetes para os números negativos, ao especificar o valor para o comprimento.

Funções relacionadas

A função STRING( ) é o inverso da VALUE( ), que converte dados de caracteres em dados numéricos.