pandas.Index.asof

Index.asof(self, label) [source]

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

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

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

См. также

Series.asof

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

merge_asof

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

Index.get_loc

An asof — это тонкий wrapper вокруг 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