polars.Series.to_pandas#

Series.to_pandas(

*,

use_pyarrow_extension_array: bool = False,

**kwargs: Any,

) → pd.Series[Any][source]#

将此系列转换为pandas系列。

如果未启用use_pyarrow_extension_array，此操作将复制数据。

Parameters:

use_pyarrow_extension_array: 使用PyArrow支持的扩展数组代替NumPy数组作为pandas Series。这允许零拷贝操作并保留空值。如果PyArrow计算函数不支持后续操作，则对生成的pandas Series的操作可能会触发转换为NumPy。
**kwargs: 额外的关键字参数传递给 pyarrow.Array.to_pandas().

Returns:

注释

此操作要求同时安装pandas和pyarrow。

示例

>>> s = pl.Series("a", [1, 2, 3])
>>> s.to_pandas()
0    1
1    2
2    3
Name: a, dtype: int64

空值被转换为NaN。

>>> s = pl.Series("b", [1, 2, None])
>>> s.to_pandas()
0    1.0
1    2.0
2    NaN
Name: b, dtype: float64

传递 use_pyarrow_extension_array=True 以获得由 PyArrow 扩展数组支持的 pandas Series。这将保留空值。

>>> s.to_pandas(use_pyarrow_extension_array=True)
0       1
1       2
2    <NA>
Name: b, dtype: int64[pyarrow]