Documentation/Calc Functions/AVERAGEIFS

Function name:
AVERAGEIFS

Category:
Statistical Analysis

Summary:
Returns the arithmetic mean of all cells in a range that satisfy given multiple criteria. The AVERAGEIFS function sums up all the results that match the logical tests and divides this sum by the quantity of selected values.

Syntax:
AVERAGEIFS(Func_Range; Range 1; Criterion 1 [; Range 2; Criterion 2][; … ; [Range 127; Criterion 127]])

Returns:
Returns a real value which is the arithmetic mean of those ranges meeting their corresponding criteria.

Arguments:
Func_range is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the mean.

Range 1 is a range of cells, a name of a named range, or a label of a column or a row, to which the corresponding criterion is to be applied.

Criterion 1 is a string expression representing a logical condition or a cell reference to such string expression. The expression can contain text, numbers, regular expressions or wildcards (if enabled in calculation options).

Range 2 and all the following mean the same as Range 1.

Criterion 2 and all the following mean the same as Criterion 1.


 * Func_Range and Range 1, Range 2... must have the same size, otherwise the function returns err:502 - Invalid argument.
 * If a cell contains TRUE, it is treated as 1, if a cell contains FALSE – as 0 (zero).
 * If no cell qualifies the Criterion then the function returns a division(#DIV/0!) error.
 * If the Criterion is not a valid one like passing just ">" sign or "!" exclamation mark then the function returns a division(#DIV/0!) error since no cell qualifies for the operation.

Additional details:

 * The search supports wildcards or regular expressions. With regular expressions enabled, you can enter "all.*", for example to find the first location of "all" followed by any characters. If you want to search for a text that is also a regular expression, you must either precede every character with a "\" character, or enclose the text into \Q...\E. You can switch the automatic evaluation of wildcards or regular expression on and off in.

Examples:
Consider the following table

Using wildcard characters
The wildcard characters question mark (?), asterisk(*), or tilde (~) can be used in criteria. A question mark (?) matches any one character and an asterisk (*) matches zero or more characters of any kind.

Reference to a cell as a criterion
If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of AVERAGEIFS function.

More examples
For more examples, download and view this [[Media:Calc_Functions_ifs.ods | Calc spreadsheet]].

Related LibreOffice functions:
AVERAGEIF

AVEDEV

AVERAGE

AVERAGEA

COUNTIFS

MAXIFS

MINIFS

SUMIFS

ODF standard:
Section 6.18.6, part 2

Equivalent Excel functions:
AVERAGEIFS