WorksheetFunction.Confidence(Double, Double, Double) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns a value that you can use to construct a confidence interval for a population mean.

public:
 double Confidence(double Arg1, double Arg2, double Arg3);

public double Confidence (double Arg1, double Arg2, double Arg3);

Public Function Confidence (Arg1 As Double, Arg2 As Double, Arg3 As Double) As Double

Parameters

Arg1: Double

The significance level used to compute the confidence level. The confidence level equals 100*(1 - alpha)%, or in other words, an alpha of 0.05 indicates a 95 percent confidence level.

Arg2: Double

The population standard deviation for the data range and is assumed to be known.

Arg3: Double

The sample size.

Returns

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 functions, see the Confidence_Norm(Double, Double, Double) and Confidence_T(Double, Double, Double) methods.

The confidence interval is a range of values. Your sample mean, x, is at the center of this range and the range is x ± Confidence. For example, if x is the sample mean of delivery times for products ordered through the mail, x ± Confidence is a range of population means. For any population mean, μ0, in this range, the probability of obtaining a sample mean further from μ0 than x is greater than alpha; for any population mean, μ0, not in this range, the probability of obtaining a sample mean further from μ0 than x is less than alpha. In other words, assume that we use x, standard_dev, and size to construct a two-tailed test at significance level alpha of the hypothesis that the population mean is μ0. Then we will not reject that hypothesis if μ0 is in the confidence interval and will reject that hypothesis if μ0 is not in the confidence interval. The confidence interval does not allow us to infer that there is probability 1 – alpha that our next package will take a delivery time that is in the confidence interval.

If any argument is nonnumeric, Confidence generates an error.

If alpha ≤ 0 or alpha ≥ 1, Confidence generates an error.

If standard_dev ≤ 0, Confidence generates an error.

If size is not an integer, it is truncated.

If size < 1, Confidence generates an error.

If we assume alpha equals 0.05, we need to calculate the area under the standard normal curve that equals (1 - alpha), or 95 percent. This value is ± 1.96. The confidence interval is therefore:

Figure 1: Confidence interval

Applies to