Converte um valor numérico em uma sequência de caracteres.
Sintaxe
STRING(número; comprimento <;formato>)
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
| número |
numérico |
O valor numérico a ser convertido em uma cadeia. |
| comprimento | numérico |
O comprimento da cadeia de saída em caracteres.
Verifique se o comprimento especificado oferece espaço suficiente para o maior valor numérico em um campo, incluindo qualquer caractere em formato não numérico caso você especifique o parâmetro opcional formato. |
| formato
opcional |
caractere |
O formato a ser aplicado à sequência de caracteres de saída. formato deve estar entre aspas. Por exemplo, "(9.999,99)" Use o parâmetro opcional formato para adicionar à cadeia de saída uma formatação não presente nos dados de origem. Você pode adicionar um símbolo de dólar ou de porcentagem, um ou mais espaços reservados decimais, um separador de milhares, parênteses e assim por diante. Nota Os caracteres de formato não numéricos especificados aumentam o comprimento do número. |
Saída
Caractere.
Exemplos
Exemplos básicos, saída não formatada
Valor numérico 125,2
Retorna " 125,2":
STRING(125,2; 6)
A cadeia de saída é preenchida com um espaço à esquerda porque o valor de comprimento é 6, que é um caractere maior que o número de dígitos e os caracteres de formato em número.
Valor numérico -125,2
Retorna "25,2":
STRING(-125,2; 4)
A cadeia de saída é truncada porque o valor de comprimento é 4, que é dois caracteres menor que o número de dígitos e os caracteres de formato em número.
Retorna " -125,2":
STRING(-125,2; 7)
A cadeia de saída é preenchida com um espaço à esquerda porque o valor de comprimento é 7, que é um caractere maior que o número de dígitos e os caracteres de formato em número.
Exemplos básicos, saída formatada
Valor numérico 125,2
Retorna "25,20":
STRING(125,2; 6; "(9.999,99)")
A cadeia de saída é truncada porque o valor de comprimento é 6, que é um caractere menor que o valor de número depois da aplicação do formato especificado.
Retorna "125,20":
STRING(125,2; 7; "(9.999,99)")
Nota
Começando da direita, os caracteres especificados para formato são incluídos no cálculo do comprimento de número, mesmo que um caractere de formato não seja necessário para uma instância específica de número. Nos exemplos acima, o parêntese à direita é contado como caractere, mesmo que não seja necessário para um valor positivo de número.
Valor numérico -125,2
Retorna " (125,20)":
STRING(-125,2; 10; "(9.999,99)")
A cadeia de saída é preenchida com dois espaços à esquerda porque o valor de comprimento é 10, que é dois caracteres maior que o valor de número depois da aplicação do formato especificado.
Exemplo básico, 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, a cadeia de saída é preenchida ou truncada:
STRING(Número_Funcionário, 10)
Observações
Formatando a cadeia de saída
Você pode formatar a cadeia de saída para exibir formatação ausente nos dados de origem.
Dígitos de espaços reservados no formato
No formato especificado, o dígito 9 atua como um espaço reservado para dígitos. Não deixe de especificar dígitos de espaço reservado suficientes para conter o número mais longo em um campo. Por exemplo, se um campo tiver valores de até US$ 5.000.000, com duas casas decimais, você precisa especificar nove dígitos de espaço reservado: "$9.999.999,99"
Como o formato afeta o comprimento mínimo necessário da cadeia de saída
O valor especificado em comprimento deve, no mínimo, ser longo o suficiente para conter todos os dígitos do valor mais longo de um campo, bem como todos os caracteres de formato especificados.
Se você quiser adicionar um símbolo de dólar e separadores de milhares ao conteúdo de um campo que tem valores de até US$ 5.000.000, precisa especificar um comprimento de 16: 9 dígitos + 6 caracteres em formato não numérico.
Retorna valores numéricos do campo Valor como cadeias de caracteres com o formato especificado exibido.
STRING(Valor; 13; "$9.999.999,99")
Retorna $4.789.123,50 como uma cadeia de caracteres:
STRING(4789123,50; 13; "$9.999.999,99")
Funções relacionadas
A função STRING( ) é o inverso da VALUE( ), que converte dados de caracteres em dados numéricos.
