pandas.DataFrame.first#

DataFrame.первый(смещение)[источник]#

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

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