Python pandas.DataFrame.to_csv用法及代码示例

用法: DataFrame.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='"', line_terminator=None, chunksize=None, date_format=None, doublequote=True, escapechar=None, decimal='.', errors='strict', storage_options=None)

将对象写入逗号分隔值 (csv) 文件。

参数：

path_or_buf：str，路径对象，file-like 对象，或无，默认无

字符串、路径对象(实现 os.PathLike[str])或实现 write() 函数的 file-like 对象。如果为 None，则结果以字符串形式返回。如果传递了非二进制文件对象，则应使用 newline=’’ 打开它，禁用通用换行符。如果传递二进制文件对象，mode 可能需要包含 ‘b’ 。

sep：str，默认“，”

长度为 1 的字符串。输出文件的字段分隔符。

na_rep：str，默认“”

缺少数据表示。

float_format：str，默认无

浮点数的格式字符串。

columns：顺序，可选

要写的列。

header：bool 或 str 列表，默认 True

写出列名。如果给出字符串列表，则假定它是列名的别名。

index：布尔值，默认为真

写行名(索引)。

index_label：str 或序列，或 False，默认无

如果需要，索引列的列标签。如果给出 None 并且 header 和 index 为 True，则使用索引名称。如果对象使用 MultiIndex，则应给出一个序列。如果 False 不打印索引名称的字段。使用 index_label=False 更容易在 R 中导入。

mode：str

Python写模式，默认‘w’。

encoding：str，可选

表示要在输出文件中使用的编码的字符串，默认为“utf-8”。如果path_or_buf 是非二进制文件对象，则不支持encoding。

compression：str 或 dict，默认 ‘infer’

用于输出数据的即时压缩。如果 ‘infer’ 和 '%s' path-like，则从以下扩展名检测压缩：'.gz'、'.bz2'、'.zip'、'.xz' 或 '.zst'(否则不压缩)。调成None无压缩。也可以是带键的字典'method'设置为 { 之一'zip','gzip','bz2','zstd'} 和其他键值对被转发到zipfile.ZipFile,gzip.GzipFile,bz2.BZ2File，或者zstandard.ZstdDecompressor，分别。例如，可以传递以下内容以加快压缩速度并创建可重现的 gzip 存档：compression={'method':'gzip', 'compresslevel':1, 'mtime':1}.

quoting：来自 csv 模块的可选常量

默认为 csv.QUOTE_MINIMAL。如果您设置了 float_format，则浮点数将转换为字符串，因此 csv.QUOTE_NONNUMERIC 会将它们视为非数字。

quotechar：str，默认“”

长度为 1 的字符串。用于引用字段的字符。

line_terminator：str，可选

要在输出文件中使用的换行符或字符序列。默认为 os.linesep ，这取决于调用此方法的操作系统(Linux 为“\n”，Windows 为“\r\n”，即)。

chunksize：整数或无

一次写入的行。

date_format：str，默认无

日期时间对象的格式字符串。

doublequote：布尔值，默认为真

控制字段内 quotechar 的引用。

escapechar：str，默认无

长度为 1 的字符串。用于在适当时转义 sep 和 quotechar 的字符。

decimal：str，默认“。”

识别为小数分隔符的字符。例如：对欧洲数据使用“,”。

errors：str，默认 ‘strict’

指定如何处理编码和解码错误。有关选项的完整列表，请参阅 open() 的错误参数。

storage_options：字典，可选

对特定存储连接有意义的额外选项，例如主机、端口、用户名、密码等。对于 HTTP(S) URL，键值对作为标头选项转发到 urllib。对于其他 URL(例如以 “s3://” 和 “gcs://” 开头)，键值对被转发到 fsspec 。有关详细信息，请参阅fsspec 和urllib。

无或字符串: 如果path_or_buf 为无，则将生成的 csv 格式作为字符串返回。否则返回无。

例子：

>>> 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.csv”的“out.zip”

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

相关用法

注：本文由纯净天空筛选整理自pandas.pydata.org大神的英文原创作品 pandas.DataFrame.to_csv。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

例子：