pandas.Index.asof

Index.asof(label) [source]

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

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

Параметры:	label : object Метка, до которой метод возвращает самую позднюю метку индекса.
Возвращает:	объект Переданную метку, если она присутствует в индексе. Предыдущую метку, если переданная метка отсутствует в отсортированном индексе или NaN если такой метки нет.

См. также

Series.asof

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

merge_asof

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

Index.get_loc

Обёртка над 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