Python | Pandas PeriodIndex.dayofyear

在 Pandas 中，日期和时间的数据可以用 PeriodIndex 类型的数据表示。PeriodIndex 类型的数据可以表示一段时间内的每个时间单位，例如每个月、每个季度、每年等。而 dayofyear 方法可以返回 PeriodIndex 对象中每个时间单位所处的年份中的第几天。

语法

PeriodIndex.dayofyear

参数

无

返回值

返回一个包含每个时间单位所处年份中的第几天的数组。

示例

import pandas as pd

# 创建一个从 2019-01-01 到 2019-12-31 的每一天的 PeriodIndex
pi = pd.period_range(start='2019-01-01', end='2019-12-31', freq='D')

# 输出该 PeriodIndex 中日期所处的年份的第几天
print(pi.dayofyear)

# 输出：
# Int64Index([  1,   2,   3, ..., 363, 364, 365], dtype='int64')

在上面的示例中，我们先使用 pd.period_range 函数创建了一个从 2019-01-01 到 2019-12-31 的每一天的 PeriodIndex 对象 pi。接着，我们使用 dayofyear 方法输出了 pi 对象中每个时间单位所处的年份的第几天。因为 2019 年共有 365 天，所以输出的数组中的值从 1 到 365。

注意事项

• dayofyear 方法只适用于 PeriodIndex 类型的数据，不能用于其它日期时间类型的数据，例如 DatetimeIndex。
• 对于不同的时间单位，年份中的第几天的定义不同。例如，对于月单位来说，一个月的第一天是该月所处年份的第 1 天，而对于季度单位来说，一个季度的第一天是该季度所处年份的第 1 天。因此，在使用 dayofyear 方法时需要注意时间单位的定义。
• 在使用 dayofyear 方法时，需要注意 PeriodIndex 对象中的数据是否按照时间序列排序。如果期间序列没有按时间排序，则结果将是错误的。