pandas.Series.first

Series.first(offset)[source]

Выбор начальных периодов временных рядов данных на основе смещения даты.

Устарело начиная с версии 2.1: first() устарело и будет удалено в будущей версии. Пожалуйста, создайте маску и отфильтруйте, используя .loc вместо этого.

Для DataFrame с отсортированным индексом DateTimeIndex эта функция может выбрать первые несколько строк на основе смещения даты.

Параметры:

смещение:str, DateOffset или dateutil.relativedelta

Длина смещения данных, которые будут выбраны. Например, «1ME» отобразит все строки, имеющие свой индекс в течение первого месяца.

Возвращает:

Series или DataFrame

Подмножество вызывающего объекта.

Возбуждает:

TypeError

Если индекс не является 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 не были возвращены.