Função SUBSTITUTE

Substitui parte de uma cadeia de caracteres de texto por uma cadeia de caracteres de texto diferente.

Sintaxe

SUBSTITUA (texto, old_text, new_text [, start_num ][, ignore_case_opt )

Parâmetros

Name Obrigatório/opcional Tipo de dados Descrição
text
Obrigatório
String
O texto ou a referência a uma célula que contém o texto em que você deseja substituir os caracteres.
Texto_antigo
Obrigatório
String
O texto a ser substituído.
new_text
Obrigatório
String
O texto que você deseja usar para substituir old_text.
start_num_opt
Opcional
Numérica
Especifica quais ocorrências de old_text substituir.
ignore_case_opt
Opcional
Boolean
FALSE se diferenciar maiúscula e minúscula; caso contrário, TRUE. O padrão é FALSE.

Valor de retorno

Cadeia de caracteres

Comentários

Se você especificar start_num_opt, somente essa ocorrência de old_text será substituída. Caso contrário, todas as ocorrências de old_text em text serão alteradas para new_text.

Use a função SUBSTITUTE para substituir um texto específico que ocorre em uma sequência de texto. Se você quiser substituir o texto que ocorre em um local específico em uma cadeia de caracteres de texto, use a função REPLACE.

Exemplo

SUBSTITUTE ("1º de janeiro de 2003", "Janeiro", "JAN")

Retornará "1 JAN 2003".

SUBSTITUTE ("1º de janeiro de 2003","janeiro","JAN")

Retornará "1 January 2003". Nenhuma alteração será feita pois a pesquisa do texto diferencia maiúscula e minúscula.