pandas.DataFrame.to_csv

DataFrame.to_csv(self, 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, 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 Строка, представляющая кодировку, используемую в выходном файле, по умолчанию ‘utf-8’. 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 : str, optional Символ новой строки или последовательность символов для использования в выходном файле. По умолчанию os.linesep, который зависит от ОС, в которой вызывается этот метод (‘n’ для Linux, ‘rn’ для Windows, т.е.). Изменено в версии 0.24.0. chunksize : int or None Строки для записи за раз. 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

Запись DataFrame в Excel-файл.

Примеры

>>> 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'