Python | Pandas Index.asof()

Python is a great language for doing data analysis, primarily because of the fantastic ecosystem of data-centric python packages. Pandas is one of those packages and makes importing and analyzing data much easier.

Pandas Index.asof() function returns return the label from the index, or, if not present, the previous one. Assuming that the index is sorted, return the passed index label if it is in the index, or return the previous index label if the passed one is not in the index.

Note: The function only works with sorted Index. If not sorted it returns error.

Syntax: Index.asof(label)

Parameters :
label : The label up to which the method returns the latest index label

Returns : The passed label if it is in the index. The previous label if the passed label is not in the sorted index or NaN if there is no such label.

Example #1: Use Index.asof() function to return the latest index label upto the passed index label.

Output :

Let’s sort the index labels first

Output :

Now we will find the latest label in the Index upto 72.

Output :

As we can see in the output, the function has returned the 69 as it is the previous index label which is smaller than 72.

 
Example #2: Use Index.asof() function to find the label of index upto a given date.

Output :

The index is already in the sorted order so we will not sort it.

Now we will apply the index.asof() function to find the index label upto the input label.

Output :

As we can see in the output, the function has returned ‘2015-12-02’ date which is the previous date present in the Index up to ‘2016-01-01’