O que a função TEXTOANTES faz?
A função TEXTOANTES devolve a parte de um texto que vem antes de um delimitador, que pode ser um caractere ou um trecho. Por padrão ela usa a primeira ocorrência, diferencia maiúsculas de minúsculas e dá #N/D se não achar o delimitador. Argumentos opcionais permitem escolher outra ocorrência, ignorar a caixa e definir um valor alternativo. Só existe no Excel 2024 e no Microsoft 365.
| Nome em português | TEXTOANTES |
|---|---|
| Nome em inglês | TEXTBEFORE |
| Categoria | Texto |
| Retorna | Texto (o trecho antes do delimitador), ou #N/D se não houver correspondência |
| Existe desde | Excel 2024 · não existe no Excel 2013 |
Qual é a sintaxe da função TEXTOANTES?
No Excel em português do Brasil os argumentos se separam com ponto e vírgula; em inglês, com vírgula. Argumentos entre colchetes são opcionais.
| Argumento | Obrigatório | O que aceita |
|---|---|---|
| texto | Sim | O texto em que a busca é feita. Curingas não são permitidos. Se for um texto vazio, o resultado é um texto vazio. |
| delimitador | Sim | O caractere ou trecho que marca onde cortar. A função devolve o que vem antes dele. Com delimitador vazio, devolve texto vazio na busca a partir do início e o texto inteiro na busca a partir do fim. |
| núm_instância | Não | Qual ocorrência do delimitador usar. O padrão é 1. Um número negativo conta a partir do fim do texto. Com 0, ou maior que o tamanho do texto, o resultado é #VALOR!. |
| modo_correspondência | Não | Define se a busca diferencia maiúsculas de minúsculas. Use 0 (padrão) para diferenciar e 1 para ignorar a diferença. |
| corresponder_final | Não | Use 1 para tratar o fim do texto como se fosse um delimitador. O padrão é 0, que não trata o fim do texto como delimitador. |
| se_não_encontrado | Não | O valor devolvido quando não há correspondência. Se for omitido, o resultado é #N/D. |
Como usar a função TEXTOANTES na prática?
Exemplo 1: Pegar o primeiro nome de uma lista
| A | B | C | |
|---|---|---|---|
| 1 | Nome completo | Primeiro nome | |
| 2 | Carla Menezes | Carla | |
| 3 | Joaquim Pires Dantas | Joaquim | |
| 4 | Beatriz | Beatriz |
=TEXTOANTES(A2;" ";;;1) Em inglês: =TEXTBEFORE(A2," ",,,1) =TEXTOANTES(A3;" ";;;1) Em inglês: =TEXTBEFORE(A3," ",,,1) =TEXTOANTES(A4;" ";;;1) Em inglês: =TEXTBEFORE(A4," ",,,1) O delimitador é um espaço. Com corresponder_final igual a 1, o fim do texto também vale como delimitador, então "Beatriz", que não tem espaço, volta inteiro em vez de dar #N/D. Os argumentos núm_instância e modo_correspondência foram pulados com vírgulas vazias.
Exemplo 2: Voltar níveis em um caminho de arquivo
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | Caminho | Antes da 2ª barra | Antes da última barra | Sem extensão | |
| 2 | relatorios/2026/marco/vendas.xlsx | relatorios/2026 | relatorios/2026/marco | relatorios/2026/marco/vendas |
=TEXTOANTES(A2;"/";2) Em inglês: =TEXTBEFORE(A2,"/",2) =TEXTOANTES(A2;"/";-1) Em inglês: =TEXTBEFORE(A2,"/",-1) =TEXTOANTES(A2;".";-1) Em inglês: =TEXTBEFORE(A2,".",-1) Com núm_instância 2, a função corta antes da segunda barra e devolve relatorios/2026. Com -1, a busca começa pelo fim e corta antes da última barra, o que remove o nome do arquivo. Na terceira fórmula, o delimitador é o ponto, e o resultado é o caminho sem a extensão .xlsx.
Exemplo 3: Valor alternativo quando não há o delimitador
| A | B | C | |
|---|---|---|---|
| 1 | Código | Prefixo | |
| 2 | CAM-0042 | CAM | |
| 3 | BONE0017 | sem hífen | |
| 4 | CAL-0108 | CAL |
=TEXTOANTES(A2;"-";;;;"sem hífen") Em inglês: =TEXTBEFORE(A2,"-",,,,"sem hífen") =TEXTOANTES(A3;"-";;;;"sem hífen") Em inglês: =TEXTBEFORE(A3,"-",,,,"sem hífen") =TEXTOANTES(A4;"-";;;;"sem hífen") Em inglês: =TEXTBEFORE(A4,"-",,,,"sem hífen") O código BONE0017 não tem hífen. Sem o último argumento, a fórmula devolveria #N/D nessa linha. Com se_não_encontrado igual a "sem hífen", a função devolve esse texto, e as outras linhas continuam devolvendo o prefixo antes do hífen.
Quais erros a função TEXTOANTES costuma dar?
#N/D
Por que acontece: O delimitador não aparece no texto, aparece com outra combinação de maiúsculas e minúsculas (a busca diferencia por padrão) ou a ocorrência pedida é maior que o número de ocorrências.
Como corrigir: Confira o delimitador, use modo_correspondência 1 para ignorar maiúsculas ou informe um valor em se_não_encontrado.
=TEXTOANTES(A2;" de ")Resultado: #N/D#VALOR!
Por que acontece: O argumento núm_instância é 0 ou maior que o tamanho do texto.
Como corrigir: Use 1 ou um número maior para contar a partir do início, ou um número negativo para contar a partir do fim.
=TEXTOANTES(A2;"-";0)Resultado: #VALOR!#NOME?
Por que acontece: A função não existe na versão do Excel em uso. Ela está disponível só no Excel 2024 e no Microsoft 365.
Como corrigir: Atualize o Excel ou use uma fórmula equivalente com ESQUERDA e LOCALIZAR, como =ESQUERDA(A2;LOCALIZAR(" ";A2)-1).
TEXTOANTES no Google Planilhas e no LibreOffice Calc
| Programa | Nome da função | Observação |
|---|---|---|
| Excel | TEXTOANTES (TEXTBEFORE) | Referência deste dicionário. |
| Google Planilhas | Não existe | A função TEXTOANTES (TEXTBEFORE) não consta na lista oficial de funções do Google Planilhas consultada em 21/10/2026. Use SPLIT para dividir o texto no delimitador e pegar a primeira parte, REGEXEXTRACT com uma expressão regular, ou ESQUERDA combinada com SEARCH. Documentação do Google |
| LibreOffice Calc | TEXTOANTES (TEXTBEFORE) | A ajuda em português descreve a função com o nome TEXTOANTES e a mesma lógica, disponível desde o LibreOffice 25.8. No Calc, o delimitador é opcional e aceita vários delimitadores; omitido ou vazio, o resultado é o erro #N/DISP. Disponível desde o LibreOffice 25.8. Ajuda do LibreOffice |
A função TEXTOANTES existe no Excel 2013?
Não existe no Excel 2013 Excel 2024
A página da Microsoft lista a TEXTOANTES só para o Excel 2024 e o Microsoft 365, e a lista de funções marca (2024). Ela não existe no Excel 2013, 2016, 2019 nem 2021.
Veja todas as funções por versão em funções do Excel por versão e, para quem ainda usa o Office 2013, em o que o Excel 2013 tem e não tem.
O que mais vale saber sobre a TEXTOANTES?
- Para pular argumentos opcionais, deixe vírgulas vazias entre eles. Em português, com ponto e vírgula, fica =TEXTOANTES(A2;" ";;;1).
- Um núm_instância negativo conta a partir do fim: -1 é a última ocorrência do delimitador e -2 é a penúltima.
- TEXTOANTES e TEXTODEPOIS formam um par. Juntas separam os dois lados de um delimitador, como o usuário e o domínio de um e-mail.
- Em versões sem a função, =ESQUERDA(A2;LOCALIZAR(" ";A2)-1) faz algo parecido, mas dá erro se o delimitador não existir e não diferencia maiúsculas de minúsculas.
Perguntas frequentes sobre a TEXTOANTES
A função TEXTOANTES funciona no Excel 2016, 2019 ou 2021?
Não. A Microsoft informa que ela está disponível apenas no Excel 2024 e no Microsoft 365. Nas outras versões, use ESQUERDA com LOCALIZAR para obter o texto antes de um delimitador.
Como pegar o texto antes da última ocorrência de um delimitador?
Use um núm_instância negativo. Em =TEXTOANTES(A2;"/";-1) a busca começa pelo fim e a função devolve tudo o que vem antes da última barra.
A TEXTOANTES diferencia maiúsculas de minúsculas?
Sim, por padrão. Para ignorar a diferença, informe 1 no quarto argumento: =TEXTOANTES(A2;" de ";;1) encontra " DE " e " de ".
Funções relacionadas
Fontes consultadas
- Microsoft: função TEXTOANTES (português)
- Microsoft: função TEXTBEFORE (inglês)
- Microsoft: funções do Excel por categoria (marcadores de versão)
- Google: lista de funções do Planilhas
- LibreOffice: ajuda da função TEXTOANTES
Consultado em 21/10/2026. Os resultados dos exemplos acima foram calculados por programa, a partir dos dados mostrados em cada tabela. Encontrou algo errado? Escreva para contato@office2013.com.br.