跳到主要内容

GetNumStdDev

Returns the number of standard deviations from the average.

Syntax​

expression.GetNumStdDev();

expression - A variable that represents a ApiAboveAverage class.

Parameters​

This method doesn't have any parameters.

Returns​

number

Example​

This example demonstrates getting the number of standard deviations from the average.

// How to check the standard deviation setting for above average conditions.

// Get the number of standard deviations used in the conditional formatting rule.

let worksheet = Api.GetActiveSheet();

worksheet.GetRange("A1").SetValue("Test Data");
worksheet.GetRange("A2").SetValue(10);
worksheet.GetRange("A3").SetValue(20);
worksheet.GetRange("A4").SetValue(30);
worksheet.GetRange("A5").SetValue(40);
worksheet.GetRange("A6").SetValue(50);

let dataRange = worksheet.GetRange("A2:A6");
let formatConditions = dataRange.GetFormatConditions();

let condition = formatConditions.AddAboveAverage();
condition.SetFillColor(Api.CreateColorFromRGB(255, 255, 0));

let numStdDev = condition.GetNumStdDev();

worksheet.GetRange("C1").SetValue("Std Deviations:");
worksheet.GetRange("C2").SetValue(numStdDev.toString());