Navegação Rápida
Função TEXTOANTES
Resumo
A função TEXTOANTES do Excel extrai o texto que aparece antes de um delimitador específico em uma cadeia de caracteres. É a função oposta à TEXTODEPOIS, ideal para separar nomes, endereços e outros dados estruturados por padrões.
Sintaxe
=TEXTOANTES(texto; delimitador; [instância_núm]; [modo_correspond]; [fim_correspond]; [se_não_encontrado])Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| texto | Texto |
Sim | Texto original onde será feita a pesquisa pelo delimitador |
| delimitador | Texto |
Sim | Caractere ou sequência que marca o ponto de corte |
| instância_núm | Número |
Não | Qual ocorrência do delimitador usar (padrão: 1) |
| modo_correspond | Número |
Não | 0=maiúsc/minúsc; 1=insensível a maiúsc/minúsc |
| fim_correspond | Número |
Não | 0=padrão; 1=considera final do texto como delimitador |
| se_não_encontrado | Qualquer |
Não | Valor retornado se delimitador não for encontrado |
Usando a função TEXTBEFORE
A função TEXTOANTES é perfeita para extrair partes específicas de texto baseado em delimitadores conhecidos, como separar nomes próprios de sobrenomes, domínios de emails, ou códigos de produtos de descrições.
Exemplos Comuns de TEXTBEFORE
Extrair nome antes do sobrenome
=TEXTOANTES(A2;" ")De 'João Silva' retorna 'João'
Segunda ocorrência do delimitador
=TEXTOANTES("Chapeuzinho Vermelho Chapeuzinho Vermelho";"Vermelho";2)Retorna 'Chapeuzinho ' (texto antes da 2ª ocorrência)
Pesquisa insensível a maiúsculas
=TEXTOANTES(A3;"vermelho";1;1)Encontra 'vermelho' independentemente de maiúsculas/minúsculas
Valor personalizado se não encontrar
=TEXTOANTES(A4;"@";1;1;1;"Sem email")Retorna 'Sem email' se não encontrar '@' no texto
Perguntas Frequentes
Erros Comuns e Soluções
#VALOR!
Cause: instância_núm = 0 ou maior que comprimento do texto
Solution: Use número válido entre 1 e número de delimitadores
#N/D
Cause: Delimitador não encontrado no texto
Solution: Verifique ortografia ou use se_não_encontrado
Notas
- Disponível apenas no Excel 365 e Excel 2021+
- Não suporta caracteres curinga (* ou ?) nos delimitadores
- Números negativos em instância_núm contam de trás para frente
Compatibilidade
Disponível em: Excel 365, Excel 2021
Não disponível em: Excel 2019 e anteriores
Conteúdo revisado pela última vez: December 9, 2025
Frequência de atualização: Conforme necessário
Versões do Excel testadas: Excel 365, Excel 2021+