Função IMPORTARTEXTO

Aplica-se A
Excel para Microsoft 365

A função IMPORTARTEXTO permite-lhe importar dados de um ficheiro baseado em texto (como CSV, TXT ou TSV) diretamente para o Excel. Pode especificar delimitadores, ignorar ou utilizar linhas e aplicar definições de codificação ou região para um controlo preciso sobre o conteúdo importado.

Nota

Esta funcionalidade está atualmente disponível para subscritores do Microsoft 365 inscritos no canal Beta do Insider, com a Versão 2502 (Compilação 18604.20002) ou posterior no Excel para Windows.

Sintaxe

A função IMPORTARTEXTO importa dados de um ficheiro baseado em texto para o Excel como uma matriz dinâmica.

A sintaxe da função IMPORTARTEXTO é:

IMPORTTEXT(path, [delimiter], [skip_rows], [take_rows], [encoding], [locale])

Argumento Descrição
caminho
(obrigatório)
O caminho do ficheiro local ou o URL do ficheiro baseado em texto que pretende importar.
delimitador Um caráter ou cadeia que especifica como as colunas são separadas no ficheiro. Se omitido, a função utiliza a tabulação como delimitador.
skip_rows Um número que especifica quantas linhas deve ignorar. Um valor negativo ignora as linhas do fim da matriz.
take_rows Um número que especifica o número de linhas a devolver. Um valor negativo retira linhas do fim da matriz.
codificação A codificação de ficheiros. Por predefinição, é utilizado UTF-8.
região Determina a formatação regional (por exemplo, formatos de data e número). Por predefinição, é utilizada a região do SO.

Nota

  • As Funções de Importação não são atualizadas automaticamente. Para atualizar os dados importados, utilize o botão Atualizar Tudo no separador Dados .
  • Pode especificar colunas de largura fixa ao transmitir uma matriz separada por vírgulas de números inteiros ascendentes no argumento delimitador.
    Exemplo: =IMPORTTEXT("C:\Data\fixedwidth.txt", {1,3})
  • Pode utilizar a função CHAR para especificar carateres especiais para o argumento delimitador.
  • Pode utilizar a função IMPORTCSV como uma alternativa mais fácil para importar ficheiros CSV.

Ligar a ficheiros de texto na Web

Ao importar um ficheiro da Web, poderá ter de fornecer credenciais ou iniciar sessão para aceder ao ficheiro de origem. Nesses casos, ser-lhe-á pedido que selecione o método de autenticação a utilizar para o URL fornecido através de uma caixa de diálogo de autenticação.

Importar Dialog.pngde Autenticação de Funções

Os métodos de autenticação disponíveis são:

  • Anónimo: selecione este método de autenticação quando o conteúdo estiver acessível publicamente e não necessitar de início de sessão.
  • Windows: selecione este método de autenticação ao aceder a um recurso que necessite das suas credenciais do Windows.
  • Básico: selecione este método de autenticação quando o recurso precisar de um nome de utilizador e palavra-passe.
  • API Web: selecione este método se o recurso Web ao qual está a ligar utilizar uma Chave de API para fins de autenticação.
  • Conta organizacional: selecione este método de autenticação se o recurso necessitar de credenciais de conta organizacional.

Para limpar as permissões concedidas durante o processo de autenticação, clique em Dados>Obter Dados> "Definições da Origem de Dados...". Em seguida, no separador "Permissões Globais", selecione o caminho do URL relevante e clique em "Limpar Permissões"

Definições de DS das Funções de Importação

Exemplos

Os exemplos seguintes baseiam-se num caminho de ficheiro de texto fictício : "C:\Data\example.txt".

Exemplo 1

Devolver as duas primeiras linhas do ficheiro de origem

Dados

Produto Categoria Preço
A 1 10
B 2 20
C 3 30
Fórmulas
=IMPORTTEXT("C:\Data\example.txt",,,2)

A seguinte ilustração mostra o resultado:

importtext-example-new-kb-edited

Exemplo 2

Ignorar a primeira linha do ficheiro de origem

Dados

Produto Categoria Preço
A 1 10
B 2 20
C 3 30
Fórmulas
=IMPORTARTEXTO("C:\Data\example.txt",;1)

A seguinte ilustração mostra o resultado:

importtext-example-new-kb-2-edited