RANK_AVG

返回数字在数字列表中的排名：相对于列表中其他值的大小。如果多个值具有相同的排名，则返回平均排名。

语法

expression.RANK_AVG(arg1, arg2, arg3);

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
arg1	必需	ApiRange | ApiName | number		将返回其排名的数字。
arg2	必需	ApiRange | ApiName | number[]		数字数组或区域。非数字值将被忽略。
arg3	可选	ApiRange | ApiName | boolean		指定数字排序方式的数值。如果为 0 或省略，则列表中的排名将按降序排列。任何其他数值表示列表中的排名将按升序排列。

返回值

number

示例

查找电子表格中某值在列表中的排名，如果存在并列则使用平均排名。

// How do I rank a number when multiple values are equal in a spreadsheet?

// Determine a value's position in a list with tied items split evenly in rank in a spreadsheet.

const worksheet = Api.GetActiveSheet();

let valueArr = [7, 6, 5, 5];

// Place the numbers in cells
for (let i = 0; i < valueArr.length; i++) {
  worksheet.GetRange("A" + (i + 1)).SetValue(valueArr[i]);
}

//method params
let number = worksheet.GetRange("A3");
let range = worksheet.GetRange("A1:A4");
let order = 0;

let func = Api.WorksheetFunction;
let ans = func.RANK_AVG(number, range, order);

worksheet.GetRange("C1").SetValue(ans);