WorksheetFunction.Frequency(Object, Object) Method

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Calculates how often values occur within a range of values, and then returns a vertical array of numbers. For example, use Frequency to count the number of test scores that fall within ranges of scores. Because Frequency returns an array, it must be entered as an array formula.

public:
 System::Object ^ Frequency(System::Object ^ Arg1, System::Object ^ Arg2);

public object Frequency (object Arg1, object Arg2);

Public Function Frequency (Arg1 As Object, Arg2 As Object) As Object

Parameters

Arg1

Object

Data_array - an array of or reference to a set of values for which you want to count frequencies. If data_array contains no values, Frequency returns an array of zeros.

Arg2

Object

Bins_array - an array of or reference to intervals into which you want to group the values in data_array. If bins_array contains no values, Frequency returns the number of elements in data_array.

Returns

Object

Remarks

Frequency is entered as an array formula after you select a range of adjacent cells into which you want the returned distribution to appear.

The number of elements in the returned array is one more than the number of elements in bins_array. The extra element in the returned array returns the count of any values above the highest interval. For example, when counting three ranges of values (intervals) that are entered into three cells, be sure to enter Frequency into four cells for the results. The extra cell returns the number of values in data_array that are greater than the third interval value.

Frequency ignores blank cells and text.

Formulas that return arrays must be entered as array formulas.