WorksheetFunction.NormDist Method

Returns the normal distribution for the specified mean and standard deviation. This function has a very wide range of applications in statistics, including hypothesis testing.

Namespace:  Microsoft.Office.Interop.Excel
Assembly:  Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)

Syntax

'Declaration
Function NormDist ( _
    Arg1 As Double, _
    Arg2 As Double, _
    Arg3 As Double, _
    Arg4 As Boolean _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Double
Dim Arg2 As Double
Dim Arg3 As Double
Dim Arg4 As Boolean
Dim returnValue As Double

returnValue = instance.NormDist(Arg1, _
    Arg2, Arg3, Arg4)
double NormDist(
    double Arg1,
    double Arg2,
    double Arg3,
    bool Arg4
)

Parameters

  • Arg1
    Type: System.Double

    X - the value for which you want the distribution.

  • Arg2
    Type: System.Double

    Mean - the arithmetic mean of the distribution.

  • Arg3
    Type: System.Double

    Standard_dev - the standard deviation of the distribution.

  • Arg4
    Type: System.Boolean

    Cumulative - a logical value that determines the form of the function. If cumulative is true, NormDist returns the cumulative distribution function; if false, it returns the probability mass function.

Return Value

Type: System.Double

Remarks

Important

This function has been replaced with one or more new functions that may provide improved accuracy and whose names better reflect their usage. This function is still available for compatibility with earlier versions of Excel. However, if backward compatibility is not required, you should consider using the new functions from now on, because they more accurately describe their functionality. For more information about the new function, see the Norm_Dist(Double, Double, Double, Boolean) method.

If mean or standard_dev is nonnumeric, NormDist returns the #VALUE! error value.

If standard_dev ≤ 0, NormDist returns the #NUM! error value.

If mean = 0, standard_dev = 1, and cumulative = true, NormDist returns the standard normal distribution, NormDist.

The equation for the normal density function (cumulative = false) is:

Figure 1: Equation for the normal density function

Equation for the normal density function

When cumulative = true, the formula is the integral from negative infinity to x of the given formula.

See Also

Reference

WorksheetFunction Interface

WorksheetFunction Members

Microsoft.Office.Interop.Excel Namespace