List.Sort
This topic applies to the Power Query Formula Language which can be used with Power Query and Power BI Desktop to build queries that mashup data. See the list of function categories.
Returns a sorted list using comparison criterion.
List.Sort(list as list, optional comparisonCriteria as any ) as list
| Argument | Description |
|---|---|
| list | The List to modify. |
| optional comparisonCriteria | Controls the sort order. For more information about equality comparisons, see Parameter Values. |
To control the order, comparison criterion can be an Order enum value.
To compute a key to be used for sorting, a function with one argument can be used.
To both select a key and control order, comparison criterion can be a list containing the key and order.
To completely control the comparison, a function with two Arguments can be used that returns -1, 0, or 1 given the relationship between the left and right inputs. Value.Compare is a method that can be used to delegate this logic.
List.Sort({2, 1}) equals {1, 2}
List.Sort({1, 2}, Order.Descending) equals {2, 1}
List.Sort({1, 2}, Order.Ascending) equals {1, 2}
List.Sort({1, 2}, each 1/_) equals{2, 1}
List.Sort({2, 1}, {each 1/_, Order.Descending}) equals {1, 2}
List.Sort({1, 2}, (x, y) => Value.Compare(1/x, 1/y)) equals {2, 1}
Show: