Applies ToExcel para Microsoft 365 Excel para Microsoft 365 para Mac Excel na Web

Devolve texto que ocorre antes de um determinado caráter ou cadeia. É o oposto da função TEXTODEPOIS.

Sintaxe

=TEXTOANTES(texto,delimitador,[número_da_instância], [modo_de_correspondência], [fim_da_correspondência], [se_não_encontrado])

A sintaxe da função TEXTOANTES tem os seguintes argumentos:

texto       O texto em que está a procurar. Não são permitidos carateres universais. Se o texto for uma cadeia vazia, o Excel devolve texto vazio. Obrigatório.

delimitador       O texto que marca o ponto antes do qual pretende extrair. Obrigatório.

instance_num       A instância do delimitador após a qual pretende extrair o texto.   Por predefinição, instance_num = 1.  Um número negativo começa a procurar texto a partir do fim. Opcional.

modo_de correspondência    Determina se a pesquisa de texto é sensível às maiúsculas e minúsculas. A predefinição é sensível às maiúsculas e minúsculas. Opcional. Introduza uma dos seguintes opções:

  • 0      Sensível às maiúsculas e minúsculas.

  • 1      Não sensível às maiúsculas e minúsculas.

fim_da_correspondência     Trata o fim do texto como um delimitador. Por predefinição, o texto é uma correspondência exata. Opcional. Introduza o seguinte:

  • 0      Não faça uma correspondência entre o delimitador e o fim do texto.

  • 1      Faça uma correspondência entre o delimitador e o fim do texto.

se_não_encontrado    Valor devolvido se não for encontrada nenhuma correspondência. Por predefinição, #N/A é devolvido. Opcional.

Observações

Ao procurar com um valor de delimitador vazio, TEXTOANTES efetua a correspondência de forma imediata. Devolve texto vazio ao procurar a partir do início (se núm_instância for positivo) e todo o texto ao procurar a partir do fim (se núm_instância for negativo).

Exemplo

Resultado

=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; "capuchinho")

A história do

=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; "")

=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; ""; -1)

A história do capuchinho vermelho; capuchinho vermelho

Erros

  • O Excel devolve um erro #VALOR! se o parâmetro número_de_instâncias = 0, ou superior ao comprimento do texto.

  • O Excel devolve um erro #N/D se delimitador não estiver contido no texto.

  • Excel devolve um erro #N/D se instance_num for maior que o número de ocorrências de delimitador no texto.

Exemplos

Copie os dados de exemplo em cada uma das tabelas seguintes e cole-os na célula A1 de uma nova folha de cálculo do Excel. Se pretender, pode ajustar as larguras das colunas para ver todos os dados.

Dados

Capuchinho Vermelho

Capuchinho vermelho

Fórmulas

Resultados

=TEXTOANTES(A2,"Vermelho")

Pouco 

=TEXTOANTES(A3,"Vermelho")

#N/D

=TEXTOANTES(A3,"vermelho",2)

Capuchinho Vermelho

=TEXTOANTES(A3;"vermelho",-2)

Pouco

=TEXTOANTES(A3;"Vermelho",,FALSO)

#N/D

=TEXTOANTES(A3;"vermelho",3)

#N/D

Dados

Marco Aurélio

Sócrates

Immanuel Kant

Fórmulas

Resultados

=TEXTOANTES(A2;" ";;;1)

Marcus

=TEXTOANTES(A3;" ";;;0)

#N/D

=TEXTOANTES(A3;" ";;;1)

Sócrates

=TEXTOANTES(A4;" ";;;1)

Immanuel

Consulte Também

Funções de texto (referência)

Função TEXTSPLIT

Função TEXTODEPOIS

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.