pandas.DataFrame.first

DataFrame.first(offset)[source]

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

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

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

Параметры:

offset: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 не были возвращены.