【Python】ExcelからCSVに書き出す｜pandas,csv

import pandas as pd
import csv
import os
from datetime import datetime
from typing import List, Optional

class ExcelToCSVExporter:
    """ExcelシートからCSVファイルをエクスポートするクラス"""

    def __init__(self, excel_file_path: str, sheet_name: str = "対象シート", use_all_columns_for_last_row: bool = False):
        """初期化"""
        self.excel_file_path = excel_file_path
        self.sheet_name = sheet_name
        self.use_all_columns_for_last_row = use_all_columns_for_last_row

        # 定数定義
        self.COL_LASTROW_BASE = "A"  # 最終行の基準とする列記号
        self.ROW_HEADER = 1          # ヘッダー行番号
        self.ROW_DATA_START = 2      # データ開始行番号

        # 出力列定義
        self.fields = ["A", "C", "E", "F", "G"]

    def export_to_csv(self, output_path: Optional[str] = None) -> str:
        """
        ExcelシートからCSVファイルをエクスポート

        Args:
            output_path: 出力ファイルパス（Noneの場合は自動生成）

        Returns:
            str: 出力ファイルパス
        """
        try:
            # Excel読み込み：先頭ゼロや文字列を守るために dtype=str、欠損は空文字へ
            df = pd.read_excel(
                self.excel_file_path,
                sheet_name=self.sheet_name,
                header=None,
                dtype=str,              # 文字列として読む
                engine="openpyxl"
            ).fillna("")                # NaN→""

            if df.empty:
                raise ValueError("シートにデータがありません")

            # 最終行を取得
            last_row = self._get_last_row(df)

            # CSVファイルパスを生成
            if output_path is None:
                output_path = self._generate_output_path()

            # UTF-8 BOM付きでCSVファイルを保存
            self._save_csv_with_bom(df, last_row, output_path)

            print(f"CSVファイルを出力しました: {output_path}")
            return output_path

        except Exception as e:
            print(f"エラーが発生しました: {str(e)}")
            raise

    def _get_last_row(self, df: pd.DataFrame) -> int:
        """
        最終行を取得

        Args:
            df: DataFrame

        Returns:
            int: 最終行番号
        """
        if self.use_all_columns_for_last_row:
            # 全列基準：全セルが空文字の行を除外して末尾を取る
            mask = (df != "").any(axis=1)
            idx = mask[mask].index
            if len(idx) == 0:
                raise ValueError("データがありません")
            return int(idx[-1]) + 1
        else:
            # A列基準
            col_a = df.iloc[:, 0]  # A列（0番目の列）
            last = col_a.last_valid_index()
            if last is None:
                raise ValueError("A列に有効データがありません")
            return int(last) + 1  # 1始まり行番号に


    def _column_letter_to_index(self, column_letter: str) -> int:
        """
        列文字を数値インデックスに変換

        Args:
            column_letter: 列文字（A, B, C, ...）

        Returns:
            int: 列インデックス（0ベース）
        """
        result = 0
        for char in column_letter:
            result = result * 26 + (ord(char) - ord('A') + 1)
        return result - 1


    def _generate_output_path(self) -> str:
        """
        出力ファイルパスを自動生成

        Returns:
            str: 出力ファイルパス
        """
        # Excelファイルと同じディレクトリに出力
        excel_dir = os.path.dirname(self.excel_file_path)
        excel_name = os.path.splitext(os.path.basename(self.excel_file_path))[0]
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")

        output_filename = f"{excel_name}_export_{timestamp}.csv"
        return os.path.join(excel_dir, output_filename)

    def _save_csv_with_bom(self, df: pd.DataFrame, last_row: int, output_path: str):
        """
        UTF-8 BOM付きでCSVファイルを保存（逐次書き込みでメモリ効率化）

        Args:
            df: DataFrame
            last_row: 最終行番号
            output_path: 出力ファイルパス
        """
        # 列インデックスに変換
        column_indices = [self._column_letter_to_index(c) for c in self.fields]

        # 範囲スライス（行：ヘッダー～最終行、列：指定列）
        start_r = self.ROW_HEADER - 1
        end_r = last_row  # ilocは終端非含まないので、そのままOK
        sub = df.iloc[start_r:end_r, column_indices]

        # 逐次書き込み（メモリ節約）
        with open(output_path, 'w', encoding='utf-8-sig', newline='') as f:
            writer = csv.writer(f)
            for row in sub.itertuples(index=False, name=None):
                writer.writerow(row)

def main():
    """メイン関数"""
    # 使用例
    excel_file = "sample.xlsx"  # Excelファイルパスを指定
    sheet_name = "対象シート"    # シート名を指定

    try:
        exporter = ExcelToCSVExporter(excel_file, sheet_name)
        output_path = exporter.export_to_csv()
        print(f"エクスポート完了: {output_path}")

    except FileNotFoundError:
        print(f"Excelファイルが見つかりません: {excel_file}")
    except Exception as e:
        print(f"エラー: {str(e)}")


if __name__ == "__main__":
    main()

with open(output_path, 'w', encoding='utf-8-sig', newline='') as f:
    writer = csv.writer(f)
    for row in sub.itertuples(index=False, name=None):
        writer.writerow(row)  # ここで1行書く