pandas.Index.asof#

окончательный Индекс.asof(метка)[источник]#

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

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

Параметры:

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

Возвращает:

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

Смотрите также

Series.asof: Возвращает последнее значение в Series до переданного индекса.
merge_asof: Выполняет asof-объединение (похоже на левое соединение, но сопоставляет по ближайшему ключу, а не по равному ключу).
Index.get_loc: An asof является тонкой обёрткой вокруг get_loc с method='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