# WorksheetFunction.Frequency (Excel)

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.

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.

**Frequency** (Arg1, Arg2)

```
Dim arrFrequency() As Variant
arrFrequency() = WorksheetFunction.Frequency(Arg1:=, Arg2:=)
```

## Arguments

Arg1, Arg2Arg1 - 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 - 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