pandas.Series.first #

系列。第一个（偏移量）[来源] #

根据日期偏移选择时间序列数据的初始周期。

自版本 2.1 起已弃用：first()已弃用并将在未来版本中删除。请改为使用.loc创建掩码和过滤器。

对于具有排序 DatetimeIndex 的 DataFrame，此函数可以根据日期偏移量选择前几行。

参数：

offset str、DateOffset 或 dateutil.relativedelta: 将选择的数据的偏移长度。例如，“1ME”将显示第一个月内具有索引的所有行。

返回：

系列或数据框: 调用者的子集。

加薪：

类型错误: 如果索引不是DatetimeIndex

也可以看看

last: 根据日期偏移选择时间序列的最终周期。
at_time: 选择一天中特定时间的值。
between_time: 选择一天中特定时间之间的值。

例子

>>> i = pd.date_range('2018-04-09', periods=4, freq='2D')
>>> ts = pd.DataFrame({'A': [1, 2, 3, 4]}, index=i)
>>> ts
            A
2018-04-09  1
2018-04-11  2
2018-04-13  3
2018-04-15  4

获取前 3 天的行数：

>>> ts.first('3D')
            A
2018-04-09  1
2018-04-11  2

请注意，返回的是前 3 个日历日的数据，而不是数据集中观察到的前 3 天，因此未返回 2018 年 4 月 13 日的数据。