WorksheetFunction.Frequency method (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.
Syntax
expression.Frequency (Arg1, Arg2)
expression A variable that represents a WorksheetFunction object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Arg1 | Required | Variant | 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 | Required | Variant | 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. |
Return value
Variant
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.
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.