PythonでpandasのDataFrameをCSVファイルに書き込む方法【to_csv()の使い方】

pandasのDataFrameをCSVファイルに出力する基本

PythonでpandasのDataFrameをCSVファイルに書き込むには、to_csv()メソッドを使用します。このメソッドは、DataFrameの内容をそのままCSV形式で保存できる、最もシンプルで一般的な方法です。

まずはサンプルデータとして、リストを値にもつ辞書を作成しましょう。

# リストの辞書を定義
d = {'Car': ['BMW', 'Lexus', 'Audi', 'Mercedes', 'Jaguar', 'Bentley'],
     'Date_of_purchase': ['2020-10-10', '2020-10-12', '2020-10-17', '2020-10-16', '2020-10-19', '2020-10-22']
}

次に、この辞書をもとにpandasのDataFrameを作成します。

dataFrame = pd.DataFrame(d)

CSVファイルの出力先をデスクトップに設定する場合は、以下のように記述します。to_csv()の引数に保存先のパスとファイル名を渡すだけで、CSVファイルが自動的に生成されます。

dataFrame.to_csv("C:\\Users\\amit_\\Desktop\\SalesRecords.csv")

完全なサンプルコード

ここまでの手順をすべてまとめたコード例がこちらです。

import pandas as pd

# リストの辞書を定義
d = {'Car': ['BMW', 'Lexus', 'Audi', 'Mercedes', 'Jaguar', 'Bentley'],
     'Date_of_purchase': ['2020-10-10', '2020-10-12', '2020-10-17', '2020-10-16', '2020-10-19', '2020-10-22']
}

# 辞書からDataFrameを作成
dataFrame = pd.DataFrame(d)
print("DataFrame...\n", dataFrame)

# DataFrameをSalesRecords.csvとして書き込み
dataFrame.to_csv("C:\\Users\\amit_\\Desktop\\SalesRecords.csv")

# 完了メッセージを表示
print("The output csv file written successfully and generated...")

実行結果

上記のコードを実行すると、以下のような出力が得られます。

DataFrame...
        Car   Date_of_purchase
0       BMW         2020-10-10
1      Lexus         2020-10-12
2       Audi         2020-10-17
3   Mercedes         2020-10-16
4     Jaguar         2020-10-19
5    Bentley         2020-10-22
The output csv file written successfully and generated...

実行後、指定した場所に「SalesRecords.csv」が正常に生成され、ファイルの中身は以下のようにDataFrameのデータがそのまま記録されます。

覚えておくと便利なto_csv()の主なオプション

• index=False：行番号（インデックス）をCSVに出力せずに保存できます。
• encoding="utf-8-sig"：Excelで開いたときに日本語が文字化けするのを防げます。
• sep=","：区切り文字を変更したい場合に指定します（デフォルトはカンマ）。

たとえばインデックスを除外してUTF-8（BOM付き）で保存したい場合は、次のように書きます。

dataFrame.to_csv("C:\\Users\\amit_\\Desktop\\SalesRecords.csv", index=False, encoding="utf-8-sig")