Compartilhar via

WorksheetFunction.AverageIfs Method

  • Artigo

Returns the average (arithmetic mean) of all cells that meet multiple criteria.

Namespace:  Microsoft.Office.Interop.Excel
Assembly:  Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)

Syntax

'Declaration
Function AverageIfs ( _
    Arg1 As Range, _
    Arg2 As Range, _
    Arg3 As Object, _
    Arg4 As Object, _
    Arg5 As Object, _
    Arg6 As Object, _
    Arg7 As Object, _
    Arg8 As Object, _
    Arg9 As Object, _
    Arg10 As Object, _
    Arg11 As Object, _
    Arg12 As Object, _
    Arg13 As Object, _
    Arg14 As Object, _
    Arg15 As Object, _
    Arg16 As Object, _
    Arg17 As Object, _
    Arg18 As Object, _
    Arg19 As Object, _
    Arg20 As Object, _
    Arg21 As Object, _
    Arg22 As Object, _
    Arg23 As Object, _
    Arg24 As Object, _
    Arg25 As Object, _
    Arg26 As Object, _
    Arg27 As Object, _
    Arg28 As Object, _
    Arg29 As Object _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Range
Dim Arg2 As Range
Dim Arg3 As Object
Dim Arg4 As Object
Dim Arg5 As Object
Dim Arg6 As Object
Dim Arg7 As Object
Dim Arg8 As Object
Dim Arg9 As Object
Dim Arg10 As Object
Dim Arg11 As Object
Dim Arg12 As Object
Dim Arg13 As Object
Dim Arg14 As Object
Dim Arg15 As Object
Dim Arg16 As Object
Dim Arg17 As Object
Dim Arg18 As Object
Dim Arg19 As Object
Dim Arg20 As Object
Dim Arg21 As Object
Dim Arg22 As Object
Dim Arg23 As Object
Dim Arg24 As Object
Dim Arg25 As Object
Dim Arg26 As Object
Dim Arg27 As Object
Dim Arg28 As Object
Dim Arg29 As Object
Dim returnValue As Double

returnValue = instance.AverageIfs(Arg1, _
    Arg2, Arg3, Arg4, Arg5, Arg6, Arg7, _
    Arg8, Arg9, Arg10, Arg11, Arg12, Arg13, _
    Arg14, Arg15, Arg16, Arg17, Arg18, _
    Arg19, Arg20, Arg21, Arg22, Arg23, _
    Arg24, Arg25, Arg26, Arg27, Arg28, _
    Arg29)

double AverageIfs(
    Range Arg1,
    Range Arg2,
    Object Arg3,
    Object Arg4,
    Object Arg5,
    Object Arg6,
    Object Arg7,
    Object Arg8,
    Object Arg9,
    Object Arg10,
    Object Arg11,
    Object Arg12,
    Object Arg13,
    Object Arg14,
    Object Arg15,
    Object Arg16,
    Object Arg17,
    Object Arg18,
    Object Arg19,
    Object Arg20,
    Object Arg21,
    Object Arg22,
    Object Arg23,
    Object Arg24,
    Object Arg25,
    Object Arg26,
    Object Arg27,
    Object Arg28,
    Object Arg29
)

Parameters

Return Value

Type: System.Double

Remarks

If a cell in average_range is an empty cell, AverageIfs ignores it.

If a cell in a criteria range is empty, AverageIfs treats it as a 0 value.

Cells in range that contain true evaluate as 1; cells in range that contain false evaluate as 0 (zero).

Each cell in average_range is used in the average calculation only if all of the corresponding criteria specified are true for that cell.

If cells in average_range are empty or contain text values that cannot be translated into numbers, AverageIfs generates an error.

If there are no cells that meet all the criteria, AverageIfs generates an error value.

You can use the wildcard characters, question mark (?) and asterisk (*), in criteria. A question mark matches any single character; an asterisk matches any sequence of characters. If you want to find an actual question mark or asterisk, type a tilde (~) before the character.

Each criteria_range does not have to be the same size and shape as average_range. The actual cells that are averaged are determined by using the top, left cell in that criteria_range as the beginning cell, and then including cells that correspond in size and shape to range. For example:

If average_range is

And the criteria_range is

Then the actual cells evaluated are

A1:A5

B1:B5

B1:B5

A1:A5

B1:B3

B1:B5

A1:B4

C1:D4

C1:D4

A1:B4

C1:C2

C1:D4

The AverageIfs function measures central tendency, which is the location of the center of a group of numbers in a statistical distribution. The three most common measures of central tendency are:

  • Average which is the arithmetic mean, and is calculated by adding a group of numbers and then dividing by the count of those numbers. For example, the average of 2, 3, 3, 5, 7, and 10 is 30 divided by 6, which is 5.

  • Median which is the middle number of a group of numbers; that is, half the numbers have values that are greater than the median, and half the numbers have values that are less than the median. For example, the median of 2, 3, 3, 5, 7, and 10 is 4.

  • Mode which is the most frequently occurring number in a group of numbers. For example, the mode of 2, 3, 3, 5, 7, and 10 is 3.

For a symmetrical distribution of a group of numbers, these three measures of central tendency are all the same. For a skewed distribution of a group of numbers, they can be different.

See Also

Reference

WorksheetFunction Interface

WorksheetFunction Members

Microsoft.Office.Interop.Excel Namespace