PRODUCTIFS function

PRODUCTIFS(TargetArray, ConditionArray, Condition, OtherConditionArray..., OtherCondition...) PRODUCTIFS(TargetArray; ConditionArray; Condition; OtherConditionArray...; OtherCondition...)

TargetArray

{ Number }

The array containing the numbers to multiply together. Only numbers corresponding to elements of the condition arrays which satisfy all the given conditions are considered. Two elements are said to correspond to each other if they are in the same position in their respective arrays.

ConditionArray

{ Number }, { Logical }, { Text } or { Color }

The array containing the values to test. Only the numbers of the first array, targetArray, which correspond to the elements of this array which satisfy the corresponding condition and also satisfy the conditions of all the other condition arrays, are used in the final calculation. Two elements are said to correspond to each other if they are in the same position in their respective arrays.

Condition

A text string specifying the condition, a number which array elements must be equal to or a formula fragment specifying the condition. Use a text string like ">3"">3" to specify a condition.

If a text string is given, the following operators are supported: < (less than), <= (less than or equal to), > (greater than), >= (greater than or equal to), = (equality, case-insensitive for text), == (equality, case-sensitive for text), <> (inequality, case-insensitive for text) and != (inequality, case-sensitive for text). "" means "only blank values," "<>" and "!=" mean "only non-blank values."

If a formula fragment is given, it must return a logical value (TRUE or FALSE) specifying whether the element under consideration should be included. To do its work, it has access to the values Element (the array element currently being tested), Index (the numeric position of the array element currently being tested, starting at 1) and Source, the corresponding condition array.

OtherConditionArray

{ Number }, { Logical }, { Text } or { Color } (accepts many)

An additional array containing values to test. The condition is specified as the next parameter.

OtherCondition

Text, Number, Logical, Color, { Text }, { Number }, { Logical } or { Color } (accepts many)

A condition for testing elements of the preceding array. Refer to the documentation for the condition parameter for more information.

Returns

Number or { Number }

The product of all array elements which satisfy one or several conditions.

Returns the product of all array elements which satisfy one or several conditions (multiplying them together). PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3", { "Eve", "Eve", "Bill" }, "Eve")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3"; { "Eve"; "Eve"; "Bill" }; "Eve") returns 40, because that is the only element of the first array where both corresponding elements in the other arrays satisfy their conditions.

In the second array { 3, 4, 5 }{ 3; 4; 5 }, 4 and 5 satisfy the ">3"">3" condition, as they are both greater than 3. In the third array, { "Eve", "Eve", "Bill" }{ "Eve"; "Eve"; "Bill" }, the two first elements satisfy the "Eve""Eve" condition, requiring matching elements to be equal to "Eve". In other words, the second and third elements of the second array match their corresponding condition, while the first and second elements of the third array match their corresponding condition. As such, only the second element of the first array is considered, resulting in a return value of 40.

Use & to reference values that reside elsewhere. This formula only considers those elements of the first array which are greater than the value of Field1:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">" & Field1)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">" & Field1)

PRODUCTIFS works with multiple conditions, but it only requires a single condition. PRODUCTIF can also be used with a single condition, and also supports using the same array for determining which elements to consider and for determining which numbers to multiply together.

This function is specific to Calcapp.

Writing conditions

PRODUCTIFS supports the following operators: < (less than), <= (less than or equal to), > (greater than), >= (greater than or equal to), = (equality, case-insensitive for text), == (equality, case-sensitive for text), <> (inequality, case-insensitive for text) and != (inequality, case-sensitive for text).

If a condition parameter is set to "", only the blank values of the corresponding array are considered. If it is set to "<>" or "!=", all non-blank values are considered.

If the operator is left out, "=" is assumed. As a result, these formulas are equivalent:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, "=4")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; "=4")
PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, "4")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; "4")
PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, 4)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; 4)

The language settings of the app are taken into account when parsing numbers that are part of a condition text string, meaning that an app configured to use German should use a decimal comma (",") as a decimal separator and an app configured to use Australian English should use a decimal point ("."). Thousands separators should not be used and negative numbers should use a leading minus sign ("-").

Specifying the condition using a formula fragment

The condition parameters can also be formula fragments. These formulas are equivalent:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3")
PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, Element > 3)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; Element > 3)

Using a formula fragment gives you access to the full power of the formula language. Consider this formula:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, (Element > 3) && ISODD(Element))PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; (Element > 3) && ISODD(Element))

The formula above returns 50, because only array elements are considered which are greater than 3 and are odd numbers, which disqualifies 3 and 4, leaving only 5 (corresponding to 50 in the first array).

&& means logical "and," || means logical "or" and ! means logical negation.

This formula returns 60,000 (30 * 40 * 5030 * 40 * 50), as 3, 4 and 5 are all considered:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, (Element > 3) || ISODD(Element))PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; (Element > 3) || ISODD(Element))

3, 4 and 5 are all considered due to the || operator, which causes all array elements to be considered which are either greater than 3 or are odd (3, 4 and 5 correspond to 30, 40 and 50 in the first array).

This formula returns 40, as only 4 is both greater than 3 and is "not odd" (even):

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, (Element > 3) && !ISODD(Element))PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; (Element > 3) && !ISODD(Element))

! in !ISODD(Element)!ISODD(Element) negates the value returned from ISODD, causing TRUE to become FALSE and vice versa.

The formula fragment is run once for every array element to be tested, and is expected to return TRUE if the element should be considered, and FALSE otherwise. To do its work, it has access to the values Element (the element of the corresponding array currently being tested), Index (the numeric position of the array element currently being tested, starting at 1) and Source, the corresponding array.

If PRODUCTIFS is used with multiple conditions, either all or none may use formula fragments.

Using wildcards in the condition to match text flexibly

When a condition array contains text strings, the condition can use special characters to match multiple text strings. This formula returns 1,000 (10 * 10010 * 100), because both "car" and "cat" match the wildcard "ca?":

PRODUCTIFS({ 10, 100 }, { "car", "cat" }, "ca?")PRODUCTIFS({ 10; 100 }; { "car"; "cat" }; "ca?")

? matches any character. "ca?" matches not only "car" and "cat", but also "cab", "can" and "cap". However, it does not match "card", because ? matches exactly one character, nor does it match "ca".

* matches no character, a single character, or multiple characters. As such, "ca*" matches everything that "ca?" matches, but also "card", "ca" and "Canada" (matching is case-insensitive).

? and * can be combined in the same pattern. Colo*r ad*s are great? matches both "Color ads are great!" and "Colour adverts are great?".

Sometimes, the special characters ? and * need to be included as-is, and not have special meaning. To achieve that, precede each special character with a tilde ("~"). This formula returns 100, because only "ca*" in the second array matches "ca~*":

PRODUCTIFS({ 10, 100 }, { "cat", "ca*" }, "ca~*")PRODUCTIFS({ 10; 100 }; { "cat"; "ca*" }; "ca~*")

In other words, to search for a verbatim "*" character, write "~*". To search for a verbatim "?" character, write "~?". Finally, to search for a verbatim "~" character, write "~~".

Regular expressions are much more powerful than wildcards, but are also harder to learn. Use REGEXMATCH in a formula fragment to use regular expressions with PRODUCTIFS.

This formula returns 10, because only "123" matches the "\d\d\d" regular expression (which only accepts exactly three numbers):

PRODUCTIFS({ 10, 100 }, { "123", "ab3" }, REGEXMATCH(Element, "\d\d\d"))PRODUCTIFS({ 10; 100 }; { "123"; "ab3" }; REGEXMATCH(Element; "\d\d\d"))

Refer to the documentation of REGEXMATCH for more information.

Using FILTER, PRODUCT and REDUCE instead of PRODUCTIFS

The work PRODUCTIFS performs can be divided into two parts: filtering out the unwanted elements from the condition arrays and then returning the product of the elements of the first array which correspond to the ones in the condition arrays which made the cut. As such, these formulas are equivalent:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3")
PRODUCT(FILTER({ 30, 40, 50 }, { 3, 4, 5 } > 3))PRODUCT(FILTER({ 30; 40; 50 }; { 3; 4; 5 } > 3))

The version using FILTER provides more flexibility, as the final step (multiplying the remaining numbers together through PRODUCT) can be replaced by another function (like SUM, which adds the remaining numbers together), independent of the filtering logic.

Of course, PRODUCTIFS is normally used with multiple conditions. FILTER also supports multiple conditions using the && or * operator. These formulas are equivalent:

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3", { "Eve", "Eve", "Bill" }, "Eve")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3"; { "Eve"; "Eve"; "Bill" }; "Eve")
PRODUCT(FILTER({ 30, 40, 50 }, { 3, 4, 5 } > 3 && { "Eve", "Eve", "Bill" } = "Eve"))PRODUCT(FILTER({ 30; 40; 50 }; { 3; 4; 5 } > 3 && { "Eve"; "Eve"; "Bill" } = "Eve"))

For even more flexibility, consider replacing PRODUCT with REDUCE. Refer to the example below for more information.

Examples

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3", { "Eve", "Eve", "Bill" }, "Eve")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3"; { "Eve"; "Eve"; "Bill" }; "Eve")

Returns 40, because that is the only element of the first array where both corresponding elements in the other arrays satisfy their conditions.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">3")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">3")

Returns 2,000 (40 * 5040 * 50). It does not return 60,000 (30 * 40 * 5030 * 40 * 50), as only 4 and 5 of the second array are greater than 3, as specified by the ">3"">3" parameter.

PRODUCTIFS({ 30, 40, 50 }, { "Eve", "Eve", "Bill" }, "Eve")PRODUCTIFS({ 30; 40; 50 }; { "Eve"; "Eve"; "Bill" }; "Eve")

Returns 1,200 (30 * 4030 * 40), as only 30 and 40 correspond to "Eve" in the second array.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, ">" & Field1)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; ">" & Field1)

Determines which of the numbers of the { 3, 4, 5 }{ 3; 4; 5 } array are greater than the value of Field1 and returns the product of the corresponding numbers of the { 30, 40, 50 }{ 30; 40; 50 } array. If Field1.ValueField1,Value is 3, 2,000 is returned (40 * 5040 * 50).

PRODUCTIFS({ 11, 22, 33 }, Field1:Field3, ">1")PRODUCTIFS({ 11; 22; 33 }; Field1:Field3; ">1")

Returns the product of the elements of the { 11, 22, 33 }{ 11; 22; 33 } array, where only elements corresponding to elements in the Field1:Field3Field1:Field3 range greater than 1 are considered.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, "=4")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; "=4")

Returns 40, which corresponds to 4 in the array { 3, 4, 5 }{ 3; 4; 5 }, which is the only element of that array which satisfies the "=4""=4" condition.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, "4")PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; "4")

Returns 40, which corresponds to 4 in the array { 3, 4, 5 }{ 3; 4; 5 }, which is the only element of that array which satisfies the "4""4" condition. Equality is implied when no operator is specified.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, 4)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; 4)

Returns 40, which corresponds to 4 in the array { 3, 4, 5 }{ 3; 4; 5 }, which is the only element of that array which satisfies the 44 condition. When a plain value is given as a condition, equality is implied. If only values equal to another value should be considered, using a plain value instead of a value enclosed in a text string is preferable, as errors can be detected at an earlier stage.

PRODUCTIFS({ 11, 12, 13 }, { 1.1, 1.2, 1.3 }, ">1.1")PRODUCTIFS({ 11; 12; 13 }; { 1,1; 1,2; 1,3 }; ">1.1")

Returns 156 (12 * 1312 * 13). It does not return 1,716 (11 * 12 * 1311 * 12 * 13), as only 1.2 and 1.3 are greater than 1.1, as specified by the ">1.1"">1.1" parameter. A decimal separator appropriate for the language of the app should be used. If that language is French, for instance, a decimal comma should be used ("1,1" instead of "1.1").

PRODUCTIFS({ 10, 100 }, { "car", "cat" }, "ca?")PRODUCTIFS({ 10; 100 }; { "car"; "cat" }; "ca?")

Returns 1,000 (10 * 10010 * 100), because both "car" and "cat" match the wildcard "ca?". ? matches exactly one (arbitrary) character.

PRODUCTIFS({ 10, 100 }, { "car", "card" }, "ca*")PRODUCTIFS({ 10; 100 }; { "car"; "card" }; "ca*")

Returns 1,000 (10 * 10010 * 100), because both "car" and "card" match the wildcard "ca*". * matches zero, one or several (arbitrary) characters.

PRODUCTIFS({ 10, 100 }, { "car", "ca*" }, "ca~*")PRODUCTIFS({ 10; 100 }; { "car"; "ca*" }; "ca~*")

Returns 100, because only "ca*" matches the wildcard "ca~*". ~ written before any other character matches it verbatim, meaning that * does not have special meaning here.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, Element > 3)PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; Element > 3)

Returns 2,000 (40 * 5040 * 50). It does not return 60,000 (30 * 40 * 5030 * 40 * 50), as only 4 and 5 of the second array are greater than 3, as specified by the Element > 3Element > 3 parameter. This example uses a formula fragment instead of a text string. It is invoked once for every tested array element, and is expected to return TRUE if the value should be considered and FALSE otherwise. To do its work, it has access to the Element value, which is the value under consideration.

PRODUCTIFS({ 30, 40, 50 }, { 3, 4, 5 }, (Element > 3) && ISODD(Element))PRODUCTIFS({ 30; 40; 50 }; { 3; 4; 5 }; (Element > 3) && ISODD(Element))

Returns 50, as only 5 in the second array is both greater than 3 and is an odd number and it corresponds to 50 in the first array. Formula fragments have access to the full power of the formula language, enabling complex conditions. && means logical "and," || means logical "or" and ! means logical negation.

PRODUCT(FILTER({ 30, 40, 50 }, { 3, 4, 5 } > 3))PRODUCT(FILTER({ 30; 40; 50 }; { 3; 4; 5 } > 3))

Returns 2,000 (40 * 5040 * 50). It does not return 60,000 (30 * 40 * 5030 * 40 * 50), as only 4 and 5 in the second array are greater than 3. FILTER returns a version of the first array, where elements corresponding to elements of the second array which failed the > 3 test are not present. Finally, PRODUCT multiplies the remaining numbers (40 and 50) together and returns the product.

PRODUCT(FILTER({ 30, 40, 50 }, { 3, 4, 5 } > 3 && { "Eve", "Eve", "Bill" } = "Eve"))PRODUCT(FILTER({ 30; 40; 50 }; { 3; 4; 5 } > 3 && { "Eve"; "Eve"; "Bill" } = "Eve"))

Returns 40, because that is the only element of the first array where both corresponding elements in the other arrays satisfy their conditions. The && operator enables FILTER to use multiple conditions.

REDUCE(FILTER({ 30, 40, 50 }, { 3, 4, 5 } > 3), (A, V) -> A * V, 1)REDUCE(FILTER({ 30; 40; 50 }; { 3; 4; 5 } > 3); (A; V) -> A * V; 1)

Returns 2,000 (40 * 5040 * 50). It does not return 60,000 (30 * 40 * 5030 * 40 * 50), as only 4 and 5 of the second array are greater than 3. REDUCE is a more flexible alternative to functions like PRODUCT. Refer to its documentation to learn how it works.

PRODUCTIFS({ 10, 100 }, { "123", "ab3" }, REGEXMATCH(Element, "\d\d\d"))PRODUCTIFS({ 10; 100 }; { "123"; "ab3" }; REGEXMATCH(Element; "\d\d\d"))

Returns 10, because only "123" matches the "\d\d\d" regular expression (which only accepts exactly three numbers). Refer to the documentation of REGEXMATCH for more information.