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’.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

mode:{‘w’, ‘x’, ‘a’}, по умолчанию ‘w’

Передаётся в open(mode=) или fsspec.open(mode=) для управления открытием файла. Типичные значения включают:

• ‘w’, обнулить файл сначала.

• ‘x’, эксклюзивное создание, если файл уже существует, завершается ошибкой.

• ‘a’, добавить в конец файла, если он существует.

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', 'xz', 'tar'} и другие пары ключ-значение передаются в zipfile.ZipFile, gzip.GzipFile, bz2.BZ2File, zstandard.ZstdCompressor, lzma.LZMAFile или tarfile.TarFile, соответственно. Например, следующее можно передать для более быстрого сжатия и создания воспроизводимого gzip архива: compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}.

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

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

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

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() для полного списка вариантов.

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

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

Возвращает:

None или str

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

См. также

read_csv

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

to_excel

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

Примеры

Создание ‘out.csv’, содержащего ‘df’ без индексов

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

Создание ‘out.zip’ содержащего ‘out.csv’

>>> df.to_csv(index=False)
'name,mask,weapon\nRaphael,red,sai\nDonatello,purple,bo staff\n'
>>> 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')