A função IMPORTTEXT permite importar dados de um arquivo baseado em texto (como CSV, TXT ou TSV) diretamente no Excel. Você pode especificar delimitadores, ignorar ou pegar linhas e aplicar configurações de codificação ou localidade para um controle preciso sobre o conteúdo importado.
Observação: Atualmente, esse recurso está disponível para assinantes do Microsoft 365 registrados no canal Beta do Insiders, executando a versão 2502 (Build 18604.20002) ou posterior no Excel para Windows.
Sintaxe
A função IMPORTTEXT importa dados de um arquivo baseado em texto para o Excel como uma matriz dinâmica.
A sintaxe da função IMPORTTEXT é:
IMPORTTEXT(path, [delimitador], [skip_rows], [take_rows], [codificação], [localidade])
|
Argumento |
Descrição |
|---|---|
|
caminho (obrigatório) |
O caminho do arquivo local ou a URL do arquivo baseado em texto que você deseja importar. |
|
delimiter |
Um caractere ou cadeia de caracteres que especifica como as colunas são separadas no arquivo. Se omitida, a função usará a guia como delimitador. |
|
skip_rows |
Um número que especifica quantas linhas faltam. Um valor negativo ignora linhas do final da matriz. |
|
take_rows |
Um número que especifica quantas linhas devem ser retornadas. Um valor negativo usa linhas do final da matriz. |
|
codificação |
A codificação de arquivo. Por padrão, UTF-8 é usado. |
|
localidade |
Determina a formatação regional (por exemplo, data, formatos de número). Por padrão, a localidade do sistema operacional é usada. |
Observações:
-
As Funções de Importação não são atualizadas automaticamente. Para atualizar dados importados, use o botão Atualizar Tudo na guia Dados .
-
Você pode especificar colunas de largura fixa passando uma matriz separada por vírgulas de inteiros crescentes no argumento delimitador.Exemplo: =IMPORTTEXT("C:\Data\fixedwidth.txt", {1,3})
-
Você pode usar a função CHAR para especificar caracteres especiais para o argumento delimitador.
-
Você pode usar a função IMPORTCSV como uma alternativa mais fácil para importar arquivos CSV.
Ao importar um arquivo da Web, talvez seja necessário fornecer credenciais ou entrar para acessar o arquivo de origem. Nesses casos, você será solicitado a selecionar o método de autenticação a ser usado para a URL fornecida por meio de uma caixa de diálogo de autenticação.
Os métodos de autenticação disponíveis são:
-
Anônimo: selecione esse método de autenticação quando o conteúdo estiver acessível publicamente e não exigir entrada.
-
Windows: selecione esse método de autenticação ao acessar um recurso que requer suas credenciais do Windows.
-
Básico: selecione esse método de autenticação quando o recurso exigir um nome de usuário e uma senha.
-
API da Web: selecione esse método se o recurso Web ao qual você está se conectando usa uma Chave de API para fins de autenticação.
-
Conta organizacional: selecione esse método de autenticação se o recurso exigir credenciais de conta organizacional.
Para limpar as permissões fornecidas durante o processo de autenticação, clique em Dados > Obter Dados > 'Configurações da Fonte de Dados...'. Em seguida, na guia 'Permissões Globais' , selecione o caminho de URL relevante e clique em 'Limpar Permissões'
Exemplos
Os exemplos a seguir são baseados em um caminho de arquivo de texto fictício: "C:\Data\example.txt".
Retornar as duas primeiras linhas do arquivo de origem
|
Dados |
||||||||||||
|
||||||||||||
|
Fórmulas |
||||||||||||
|
=IMPORTTEXT("C:\Data\example.txt",,,2) |
A ilustração a seguir mostra o resultado:
Ignorar a primeira linha do arquivo de origem
|
Dados |
||||||||||||
|
||||||||||||
|
Fórmulas |
||||||||||||
|
=IMPORTTEXT("C:\Data\example.txt",,1) |
A ilustração a seguir mostra o resultado:
