dask.dataframe.DataFrame.first

dask.dataframe.DataFrame.first

DataFrame.first(offset)

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

此文档字符串是从 pandas.core.frame.DataFrame.first 复制而来的。

Dask 版本可能存在一些不一致性。

2.1 版后已移除: first() 已被弃用,并将在未来的版本中移除。请使用 .loc 创建掩码和过滤器。

对于一个带有已排序的 DatetimeIndex 的 DataFrame,此函数可以根据日期偏移量选择前几行。

参数
偏移量str, DateOffset 或 dateutil.relativedelta

将被选择的数据的偏移长度。例如,’1ME’ 将显示其索引在第一个月内的所有行。

返回
Series 或 DataFrame

调用者的一个子集。

Raises
类型错误

如果索引不是 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-04-13的数据未被返回。