IMPORTTEXT 関数

適用先
Excel for Microsoft 365

IMPORTTEXT 関数を使用すると、テキストベースのファイル (CSV、TXT、TSV など) から Excel に直接データをインポートできます。 区切り記号を指定したり、行をスキップまたは取得したり、エンコーディングまたはロケール設定を適用して、インポートされたコンテンツを正確に制御したりできます。

この機能は現在、Excel for Windows でバージョン 2502 (ビルド 18604.20002) 以降を実行して、Insider ベータ チャネルに登録されている Microsoft 365 サブスクライバーが一般公開されています。

構文

IMPORTTEXT 関数は、テキストベースのファイルからデータを動的配列として Excel にインポートします。

IMPORTTEXT 関数の構文は次のとおりです。

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

引数 説明
path
(必須)
インポートするテキストベースのファイルのローカル ファイル パスまたは URL。
区切り記号 ファイル内で列を区切る方法を指定する文字または文字列。 省略した場合、関数は区切り記号として tab を使用します。
skip_rows スキップする行数を指定する番号。 負の値は、配列の末尾から行をスキップします。
take_rows 返す行数を指定する数値。 負の値は、配列の末尾から行を取得します。
エンコード ファイルのエンコーディング。 既定では、UTF-8 が使用されます。
ロケール 地域書式 (日付、数値の書式など) を決定します。 既定では、OS ロケールが使用されます。

  • インポート関数は自動的に更新されません。 インポートしたデータを更新するには、[データ] タブの [すべて更新] ボタンを使用します。
  • 固定幅の列を指定するには、delimiter 引数に昇順整数のコンマ区切り配列を渡します。
    : =IMPORTTEXT("C:\Data\fixedwidth.txt", {1,3})
  • CHAR 関数を使用して、区切り記号引数に特殊文字を指定できます。
  • CSV ファイルをインポートするより簡単な代替手段として、 IMPORTCSV 関数 を使用できます。

Web 上のテキスト ファイルへの接続

Web からファイルをインポートする場合、資格情報を入力するか、サインインしてソース ファイルにアクセスすることが必要な場合があります。 このような場合は、認証ダイアログを使用して、指定された URL に使用する認証方法を選択するように求められます。

Import Functions Auth Dialog.png

使用できる認証方法は次のとおりです。

  • 匿名: コンテンツが パブリックにアクセス可能 であり、 サインインを必要としない場合は、この認証方法を選択します。
  • Windows: Windows 資格情報を必要とするリソースにアクセスする場合は、この認証方法を選択します。
  • [基本]: リソースで ユーザー名パスワードが必要な場合は、この認証方法を選択します。
  • Web API: 接続先の Web リソースが認証目的で API キーを使用している場合は、この方法を選択します。
  • [組織アカウント]: リソースで組織アカウントの資格情報が必要な場合は、この認証方法を選択します。

認証プロセス中に指定されたアクセス許可をクリアするには、[データ>データの取得]> [データ ソース設定...] をクリックします。 次に、「グローバル権限」タブで、関連するURLパスを選択し、「権限のクリア」をクリックします

関数のインポート DS 設定

次の例は架 のテキスト ファイル パス "C:\Data\example.txt" に基づいています。

例 1

ソース ファイルの最初の 2 行を返します

データ

製品 [カテゴリ] 価格
A 1 10
B 2 20
C 3 30
数式
=IMPORTTEXT("C:\Data\example.txt",,,2)

結果 を次の図に示します。

importtext-example-new-kb-edited

使用例 2

ソース ファイルから最初の行をスキップする

データ

製品 [カテゴリ] 価格
A 1 10
B 2 20
C 3 30
数式
=IMPORTTEXT("C:\Data\example.txt",,1)

結果 を次の図に示します。

importtext-example-new-kb-2-edited