Notas de versão
Canal Empresarial Semestral (Visualização)
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 a 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 é sensível a casos. O padrão é diferenciar maiúsculas de minúsculas. Opcional. Insira uma das seguintes opções:
- 0 Confidencial de caso.
- 1 Caso insensível.
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 corresponda ao delimitador com o final do texto.
- 1 Corresponda ao delimitador com o 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", "hood") | Passeio vermelho |
| =TEXTBEFORE("Chapeuzinho vermelho, capuz vermelho", "") | |
| =TEXTBEFORE("Chapeuzinho vermelho, capô vermelho", "", -1) | Capuz vermelho, capuz vermelho |
Erros
- Excel retorna um #VALOR! 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.
Exemplo 1
| O capuz vermelho da Chapeuzinho Vermelho | ||
|---|---|---|
| Dados | ||
| 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 |
Exemplo 2
| 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 |