pandas.DataFrame.to_csv

DataFrame.to_csv(path_or_buf=None, sep=', ', na_rep='', float_format=None, columns=None, header=True, index=True, index_label=None, mode='w', encoding=None, compression='infer', quoting=None, quotechar='"', line_terminator=None, chunksize=None, tupleize_cols=None, date_format=None, doublequote=True, escapechar=None, decimal='.') [source]

Запись объекта в файл с разделителем запятых (csv).

Изменено в версии 0.24.0: Изменён порядок аргументов для Series.

Параметры:

path_or_buf : str or file handle, default None Путь к файлу или объект; если None, результат возвращается в виде строки. Если передаётся объект файла, он должен быть открыт с помощью newline=’‘, отключив универсальные переводы строк. Изменено в версии 0.24.0: Ранее назывался “path” для Series. sep : str, default ‘,’ Строка длиной 1. Разделитель полей для выходного файла. na_rep : str, default ‘’ Представление пропущенных данных. float_format : str, default None Форматная строка для чисел с плавающей точкой. columns : sequence, optional Столбцы для записи. header : bool or list of str, default True Запись имён столбцов. Если задан список строк, предполагается, что это псевдонимы имён столбцов. Изменено в версии 0.24.0: Ранее по умолчанию было False для Series. index : bool, default True Запись имён строк (индекс). index_label : str or sequence, or False, default None Имя столбца для столбца(ов) индекса, если необходимо. Если задано None, и header и index равны True, то используются имена индекса. Должен быть задан последовательность, если объект использует MultiIndex. Если False, не выводить поля для имён индекса. Используйте index_label=False для более лёгкого импорта в R. mode : str Режим записи Python, по умолчанию ‘w’. encoding : str, optional Строка, представляющая кодировку, используемую в выходном файле, по умолчанию ‘ascii’ в Python 2 и ‘utf-8’ в Python 3. compression : str, default ‘infer’ Режим сжатия среди следующих возможных значений: {‘infer’, ‘gzip’, ‘bz2’, ‘zip’, ‘xz’, None}. Если ‘infer’ и path_or_buf является путём, то обнаружить сжатие из следующих расширений: ‘.gz’, ‘.bz2’, ‘.zip’ или ‘.xz’. (в противном случае сжатие отсутствует). Изменено в версии 0.24.0: Добавлен параметр ‘infer’ по умолчанию. quoting : optional constant from csv module По умолчанию csv.QUOTE_MINIMAL. Если задан float_format, то числа с плавающей точкой преобразуются в строки, и поэтому csv.QUOTE_NONNUMERIC будет рассматривать их как нечисловые. quotechar : str, default ‘"’ Строка длиной 1. Символ, используемый для цитирования полей. line_terminator : string, optional Символ или последовательность символов новой строки, используемая в выходном файле. По умолчанию os.linesep, что зависит от ОС, в которой вызывается этот метод (‘n’ для Linux, ‘rn’ для Windows, т.е.). Изменено в версии 0.24.0. chunksize : int or None Строки для записи за раз. tupleize_cols : bool, default False Запись столбцов MultiIndex в виде списка кортежей (если True) или в новом расширенном формате, где каждый столбец MultiIndex является строкой в CSV (если False). Устарело начиная с версии 0.21.0: Этот аргумент будет удалён и всегда будет записывать каждую строку многоуровневого индекса как отдельную строку в файле CSV. date_format : str, default None Форматная строка для объектов datetime. doublequote : bool, default True Управление цитированием quotechar внутри поля. escapechar : str, default None Строка длиной 1. Символ, используемый для экранирования sep и quotechar при необходимости. decimal : str, default ‘.’ Символ, распознаваемый как десятичный разделитель. Например, используйте ‘,’ для европейских данных.

Возвращаемое значение:

None или str Если path_or_buf равно None, возвращает результат в формате csv в виде строки. В противном случае возвращает None.

См. также

read_csv

Загрузка файла CSV в DataFrame.

to_excel

Загрузка файла Excel в DataFrame.

Примеры

>>> df = pd.DataFrame({'name': ['Raphael', 'Donatello'],
...                    'mask': ['red', 'purple'],
...                    'weapon': ['sai', 'bo staff']})
>>> df.to_csv(index=False)
'name,mask,weapon\nRaphael,red,sai\nDonatello,purple,bo staff\n'