WorksheetFunction.Confidence Method
Returns a value that you can use to construct a confidence interval for a population mean.
Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)
Syntax
'Declaration
Function Confidence ( _
Arg1 As Double, _
Arg2 As Double, _
Arg3 As Double _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Double
Dim Arg2 As Double
Dim Arg3 As Double
Dim returnValue As Double
returnValue = instance.Confidence(Arg1, _
Arg2, Arg3)
double Confidence(
double Arg1,
double Arg2,
double Arg3
)
Parameters
Arg1
Type: System.DoubleThe 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
Type: System.DoubleThe population standard deviation for the data range and is assumed to be known.
Arg3
Type: System.DoubleThe sample size.
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 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
.jpg "Confidence interval")