Skip to main content

NORM_DIST

Returns the normal distribution for the specified mean and standard deviation.

Syntax

expression.NORM_DIST(arg1, arg2, arg3, arg4);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberThe value for which the distribution will be returned.
arg2RequiredApiRange | ApiName | numberThe arithmetic mean of the distribution.
arg3RequiredApiRange | ApiName | numberThe standard deviation of the distribution, a positive number.
arg4RequiredApiRange | ApiName | booleanA logical value (true or false) that determines the function form. If it is true, the function returns the cumulative distribution function. If it is false, the function returns the probability mass function.

Returns

number

Example

Return the normal distribution for the specified mean and standard deviation in a spreadsheet.

// How to calculate the normal distribution in a spreadsheet.

// Use a function to get the normal distribution knowing the mean and standard deviation in a spreadsheet.

const worksheet = Api.GetActiveSheet();
let valueArr = [36, 6, 7, false];

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

//method params
let x = worksheet.GetRange("A1").GetValue();
let mean = worksheet.GetRange("A2").GetValue();
let standardDeviation = worksheet.GetRange("A3").GetValue();
let cumulative = worksheet.GetRange("A4").GetValue();
let func = Api.WorksheetFunction;
let normalDist = func.NORM_DIST(x, mean, standardDeviation, cumulative);
worksheet.GetRange("C1").SetValue(normalDist);