Retorna o texto que ocorre antes de um determinado caractere ou cadeia de caracteres. É o oposto da função TEXTWAFTER.
Sintaxe
=TEXTBEFORE(text,delimiter,[instance_num], [match_mode], [match_end], [if_not_found])
A sintaxe da função TEXTBEFORE tem os seguintes argumentos:
texto O texto em que você está pesquisando. Caracteres curinga não são permitidos. Se o texto for uma cadeia de caracteres vazia, o Excel retornará texto vazio. Obrigatório.
delimitador O texto que marca o ponto antes do qual você deseja extrair. Obrigatório.
instance_num A instância do delimitador após o qual você deseja extrair o texto. Por padrão, instance_num = 1. Um número negativo começa a pesquisar o texto a partir do final. Opcional.
match_mode Determina se a pesquisa de texto diferencia maiúsculas de minúsculas. O padrão é diferenciar maiúsculas de minúsculas. Opcional. Insira uma das seguintes opções:
-
0 Diferenciar maiúsculas de minúsculas.
-
1 Não diferenciar maiúsculas de minúsculas.
match_end Trata o final do texto como um delimitador. Por padrão, o texto é uma correspondência exata. Opcional. Insira o seguinte:
-
0 Não corresponde ao delimitador em relação ao final do texto.
-
1 Corresponder o delimitador ao final do texto.
if_not_found Valor retornado se nenhuma correspondência for encontrada. Por padrão, #N/A é retornado. Opcional.
Comentários
Ao pesquisar com um valor delimitador vazio, TEXTBEFORE corresponde imediatamente. Ele retorna texto vazio ao pesquisar pela frente (se instance_num for positivo) e todo o texto ao pesquisar a partir do final (se instance_num for negativo).
|
Exemplo |
Resultado |
|---|---|
|
=TEXTBEFORE("Chapeuzinho vermelho, capuz vermelho", "capuz") |
Passeio vermelho |
|
=TEXTBEFORE("Chapeuzinho vermelho, capuz vermelho", "") |
|
|
=TEXTBEFORE("Chapeuzinho vermelho, capuz vermelho", "", -1) |
Chapeuzinho Vermelho, Capuz Vermelho |
Erros
-
Excel retorna um #VALUE! o erro se instance_num = 0 ou se instance_num for maior que o comprimento do texto.
-
O Excel retorna um erro #N/A se o delimitador não estiver contido no texto.
-
O Excel retornará um erro #N/A se instance_num for maior que o número de ocorrências do delimitador no texto.
Exemplos
Copie os dados de exemplo em cada uma das tabelas a seguir e cole-os na célula A1 de uma nova planilha do Excel. Se precisar, você poderá ajustar as larguras das colunas para ver todos os dados.
|
Dados |
||
|
O capuz vermelho da Chapeuzinho Vermelho |
||
|
Chapeuzinho Vermelho Chapeuzinho Vermelho |
||
|
Fórmulas |
Resultados |
|
|
=TEXTBEFORE(A2,"Vermelho") |
Pouco |
|
|
=TEXTBEFORE(A3,"Vermelho") |
#N/D |
|
|
=TEXTBEFORE(A3,"Vermelho",2) |
Pequena Chapeuzinho vermelho |
|
|
=TEXTBEFORE(A3,"vermelho",-2) |
Pouco |
|
|
=TEXTBEFORE(A3,"Vermelho",,FALSE) |
#N/D |
|
|
=TEXTBEFORE(A3,"vermelho",3) |
#N/D |
|
Dados |
|
|
Marcus Aurelius |
|
|
Sócrates |
|
|
Immanuel Kant |
|
|
Fórmulas |
Resultados |
|
=TEXTOANTES(A2," ",,,1) |
Marcos |
|
=TEXTOANTES(A3," ",,,0) |
#N/D |
|
=TEXTOANTES(A3," ",,,1) |
Sócrates |
|
=TEXTOANTES(A4," ",,,1) |
Immanuel |
