pandas.Index.asof

finalIndex.asof(label)[source]

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

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

Параметры

label:объект

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

Возвращает

объект

Переданная метка, если она есть в индексе. Предыдущая метка, если переданная метка не содержится в отсортированном индексе, или 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