pandas.Series.array

property Series.array

支持此 Series 或 Index 的基础数据的 ExtensionArray。

Returns:

ExtensionArray

包含存储在其中的值的一个 ExtensionArray。对于扩展类型，这是实际的数组。对于 NumPy 本机类型，这是 numpy.ndarray 的一个轻量级（无拷贝）包装器。

.array 与 .values 不同，后者可能需要将数据转换为不同的形式。

参见

Index.to_numpy

始终返回 NumPy 数组的类似方法。

Series.to_numpy

始终返回 NumPy 数组的类似方法。

Notes

此表列出了 pandas 中每个扩展 dtype 的不同数组类型。

dtype	array type
category	Categorical
period	PeriodArray
interval	IntervalArray
IntegerNA	IntegerArray
string	StringArray
boolean	BooleanArray
datetime64[ns, tz]	DatetimeArray

对于任何第三方扩展类型，数组类型将是 ExtensionArray。

对于所有其余的 dtype，.array 将是一个 arrays.NumpyExtensionArray ，它包装了实际存储在内部的 ndarray。如果你绝对需要一个 NumPy 数组（可能需要复制/强制转换数据），请改用 Series.to_numpy() 。

Examples

对于像 int 和 float 这样的常规 NumPy 类型，将返回 NumpyExtensionArray。

>>> pd.Series([1, 2, 3]).array
<NumpyExtensionArray>
[1, 2, 3]
Length: 3, dtype: int64

对于像 Categorical 这样的扩展类型，将返回实际的 ExtensionArray。

>>> ser = pd.Series(pd.Categorical(['a', 'b', 'a']))
>>> ser.array
['a', 'b', 'a']
Categories (2, object): ['a', 'b']