pandas.Series.to_period

Series.to_period(freq=None, copy=<no_default>)

将 Series 从 DatetimeIndex 转换为 PeriodIndex。

参数:

freqstr, 默认为 None

与 PeriodIndex 相关的频率。

复制bool, 默认 False

是否返回一个副本。

备注

copy 关键字将在 pandas 3.0 中更改行为。写时复制 将默认启用，这意味着所有带有 copy 关键字的方法将使用延迟复制机制来推迟复制并忽略 copy 关键字。copy 关键字将在 pandas 的未来版本中被移除。

通过启用写时复制 pd.options.mode.copy_on_write = True，您已经可以获得未来的行为和改进。

自 3.0.0 版本弃用.

返回:

系列

带有索引转换为 PeriodIndex 的系列。

参见

DataFrame.to_period

DataFrame 的等效方法

Series.dt.to_period

转换 DateTime 列的值。

例子

>>> idx = pd.DatetimeIndex(["2023", "2024", "2025"])
>>> s = pd.Series([1, 2, 3], index=idx)
>>> s = s.to_period()
>>> s
2023    1
2024    2
2025    3
Freq: Y-DEC, dtype: int64

查看索引

>>> s.index
PeriodIndex(['2023', '2024', '2025'], dtype='period[Y-DEC]')