pandas.DataFrame.sort_values

DataFrame.sortvalues(_by, axis=0, ascending=True, inplace=False, kind=‘quicksort’, naposition_=‘last’, ignoreindex_=__False, key=None)[source]
Sort by the values along either axis.
Parameters
bystr or list of str
Name or list of names to sort by.

  • if axis is 0 or ‘index’ then by may contain index levels and/or column labels.
  • if axis is 1 or ‘columns’ then by may contain column levels and/or index labels.

axis{0 or ‘index’, 1 or ‘columns’}, default 0
Axis to be sorted.
ascendingbool or list of bool, default True
Sort ascending vs. descending. Specify list for multiple sort orders. If this is a list of bools, must match the length of the by. 升序排序与降序排序。为多个排序顺序指定列表。如果这是一个bools的列表,必须与by的长度一致。
inplacebool, default False
If True, perform operation in-place.
kind{‘quicksort’, ‘mergesort’, ‘heapsort’, ‘stable’}, default ‘quicksort’
Choice of sorting algorithm. See also numpy.sort() for more information. mergesort and stable are the only stable algorithms. For DataFrames, this option is only applied when sorting on a single column or label.
naposition{‘first’, ‘last’}, default ‘last’_
Puts NaNs at the beginning if first; last puts NaNs at the end.
ignoreindex_bool, default False
If True, the resulting axis will be labeled 0, 1, …, n - 1.
New in version 1.0.0.
keycallable, optional
Apply the key function to the values before sorting. This is similar to the key argument in the builtin sorted() function, with the notable difference that this key function should be vectorized. It should expect a Series and return a Series with the same shape as the input. It will be applied to each column in by independently.
New in version 1.1.0.
Returns
DataFrame or None
DataFrame with sorted values or None if inplace=True.