pandas.Index.asof

finalIndex.asof(label)[source]

Возвращает метку из индекса или, если метка отсутствует, предыдущую.

Предполагая, что индекс отсортирован, возвращает переданную метку индекса, если она есть в индексе, или возвращает предыдущую метку индекса, если переданная метка отсутствует в индексе.

Параметры:

label:object

Метка до которой метод возвращает последнюю метку индекса.

Возвращает:

object

Переданная метка, если она есть в индексе. Предыдущая метка, если переданная метка отсутствует в отсортированном индексе, или NaN, если такой метки нет.

См. также

Series.asof

Возвращает последнее значение в Series до переданного индекса.

merge_asof

Выполняет слияние asof (аналогично левому объединению, но он соответствует ближайшему ключу, а не равному ключу).

Index.get_loc

asof — это тонкий обертка вокруг get_loc с методом=’pad’.

Примеры

Index.asof возвращает последнюю метку индекса до переданной метки.

>>> idx = pd.Index(['2013-12-31', '2014-01-02', '2014-01-03'])
>>> idx.asof('2014-01-01')
'2013-12-31'

Если метка есть в индексе, метод возвращает переданную метку.

>>> idx.asof('2014-01-02')
'2014-01-02'

Если все метки в индексе позже переданной метки, возвращается NaN.

>>> idx.asof('1999-01-02')
nan

Если индекс не отсортирован, генерируется ошибка.

>>> idx_not_sorted = pd.Index(['2013-12-31', '2015-01-02',
...                            '2014-01-03'])
>>> idx_not_sorted.asof('2013-12-31')
Traceback (most recent call last):
ValueError: index must be monotonic increasing or decreasing