pandas.Series.to_csv

Series.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='"', lineterminator=None, chunksize=None, date_format=None, doublequote=True, escapechar=None, decimal='.', errors='strict', storage_options=None)[source]

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

Параметры

path_or_buf:str, путь к файлу, объект файла или None, по умолчанию None

Строка, объект пути (реализующий os.PathLike[str]) или объект файла, реализующий функцию write(). Если None, результат возвращается как строка. Если передается объект небинарного файла, он должен быть открыт с newline=’’, отключая универсальные переводы строк. Если передается объект бинарного файла, mode может потребоваться содержать ‘b’.

Изменено в версии 1.2.0: Добавлена поддержка бинарных объектов файлов.

sep:str, по умолчанию ‘,’

Строка длиной 1. Разделитель полей для выходного файла.

na_rep:str, по умолчанию ‘’

Представление отсутствующих данных.

float_format:str, Callable, по умолчанию None

Строка форматирования для чисел с плавающей точкой. Если задана вызываемая функция, она имеет приоритет перед другими параметрами форматирования чисел, такими как decimal.

columns:последовательность, необязательно

Столбцы для записи.

header:bool или список строк, по умолчанию True

Записать имена столбцов. Если задан список строк, предполагается, что это псевдонимы для имен столбцов.

index:bool, по умолчанию True

Записать имена строк (индекс).

index_label:строка или последовательность, или False, по умолчанию None

Имя столбца для столбцов индекса, если необходимо. Если задано None, и header и index равны True, то используются имена индекса. Последовательность должна быть задана, если объект использует MultiIndex. Если False, не печатать поля для имён индексов. Используйте index_label=False для более лёгкого импорта в R.

mode:str, по умолчанию ‘w’

Режим записи Python. Доступные режимы записи такие же, как open().

encoding:str, необязательно

Строка, представляющая кодировку, которую следует использовать в выходном файле, по умолчанию ‘utf-8’. encoding не поддерживается, если path_or_buf является объектом небинарного файла.

compression:str или dict, по умолчанию ‘infer’

Для сжатия выходных данных в режиме реального времени. Если ‘infer’ и ‘path_or_buf’ является похожим на путь, тогда обнаружение сжатия из следующих расширений: ‘.gz’, ‘.bz2’, ‘.zip’, ‘.xz’, ‘.zst’, ‘.tar’, ‘.tar.gz’, ‘.tar.xz’ или ‘.tar.bz2’ (иначе без сжатия). Установите в None для отсутствия сжатия. Также может быть словарь с ключом 'method', установленным в один из {'zip', 'gzip', 'bz2', 'zstd', 'tar'} и другие пары ключ-значение передаются в zipfile.ZipFile, gzip.GzipFile, bz2.BZ2File, zstandard.ZstdCompressor или tarfile.TarFile, соответственно. Например, следующее можно передать для более быстрого сжатия и создания воспроизводимого gzip-архива: compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}.

Новое в версии 1.5.0: Добавлена поддержка файлов .tar.

Изменено в версии 1.0.0: Теперь может быть словарем с ключом ‘method’ как режим сжатия и другими записями как дополнительными параметрами сжатия, если режим сжатия ‘zip’.

Изменено в версии 1.1.0: Поддерживается передача параметров сжатия в виде ключей в словаре для режимов сжатия ‘gzip’, ‘bz2’, ‘zstd’ и ‘zip’.

Изменено в версии 1.2.0: Сжатие поддерживается для бинарных объектов файлов.

Изменено в версии 1.2.0: Предыдущие версии пересылали записи словаря для ‘gzip’ в gzip.open вместо gzip.GzipFile, что препятствовало установке mtime.

quoting:необязательная константа из модуля csv

По умолчанию csv.QUOTE_MINIMAL. Если задан float_format, то числа с плавающей точкой преобразуются в строки, и поэтому csv.QUOTE_NONNUMERIC будет обрабатывать их как нечисловые.

quotechar:str, по умолчанию ‘"’

Строка длиной 1. Символ, используемый для кавычек в полях.

lineterminator:str, необязательно

Символ или последовательность символов новой строки, которые следует использовать в выходном файле. По умолчанию os.linesep, который зависит от ОС, в которой вызывается этот метод (’\n’ для Linux, ‘\r\n’ для Windows, т.е.).

Изменено в версии 1.5.0: Ранее line_terminator, изменено для согласованности с read_csv и стандартным модулем ‘csv’.

chunksize:int или None

Строки для записи за раз.

date_format:str, по умолчанию None

Строка форматирования для объектов datetime.

doublequote:bool, по умолчанию True

Управление кавычками quotechar внутри поля.

escapechar:str, по умолчанию None

Строка длиной 1. Символ, используемый для экранирования sep и quotechar при необходимости.

decimal:str, по умолчанию ‘.’

Символ, распознаваемый как десятичный разделитель. Например, используйте ‘,’ для европейских данных.

errors:str, по умолчанию ‘strict’

Определяет, как обрабатывать ошибки кодирования и декодирования. См. аргумент errors для open() для полного списка вариантов.

Новое в версии 1.1.0.

storage_options:dict, необязательно

Дополнительные параметры, которые имеют смысл для определённого подключения к хранилищу, например, хост, порт, имя пользователя, пароль и т. д. Для HTTP(S) URL-адресов пары ключ-значение передаются в urllib.request.Request в качестве параметров заголовка. Для других URL-адресов (например, начинающихся с “s3://”, и “gcs://”) пары ключ-значение передаются в fsspec.open. Пожалуйста, см. fsspec и urllib для более подробной информации, а для более подробных примеров параметров хранения см здесь.

Новое в версии 1.2.0.

Возвращает

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'

Создать ‘out.zip’ содержащий ‘out.csv’

>>> compression_opts = dict(method='zip',
...                         archive_name='out.csv')  
>>> df.to_csv('out.zip', index=False,
...           compression=compression_opts)  

Чтобы записать файл csv в новую папку или вложенную папку, сначала необходимо создать её с помощью Pathlib или os:

>>> from pathlib import Path  
>>> filepath = Path('folder/subfolder/out.csv')  
>>> filepath.parent.mkdir(parents=True, exist_ok=True)  
>>> df.to_csv(filepath)  

>>> import os  
>>> os.makedirs('folder/subfolder', exist_ok=True)  
>>> df.to_csv('folder/subfolder/out.csv')