pandas.Series.to_csv

Series.to_csv(*args, **kwargs) [source]

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

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

Параметры:

path_or_buf : str or file handle, default None Путь к файлу или объект. Если передано значение None, результат возвращается в виде строки. Если передается объект файла, он должен быть открыт с newline=’‘, отключая универсальные новые строки. Изменено в версии 0.24.0: Ранее называлось «путь» для 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'