pandas.Series.to_csv

Series.to_csv(self, *args, **kwargs) [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'