Skip to content
Adaptam Docs

VALUE_IF

First value in a range that matches one or more conditions. Works with any data type.

Function syntax

VALUE_IF(value_range, filtering_range1, condition1, ...)

Arguments:

  • value_range: The range containing the values to search.
  • filtering_range1: The range to check against condition1.
  • condition1: The value(s) to match in the filtering range.
  • filtering_range2, condition2, …: (optional) Additional filtering range and condition pairs.

Provide the value range first, then pairs of filtering range and condition. All ranges must be single-column and the same height. When multiple conditions are provided, all must match. Returns the first matching value found.

Examples

  • VALUE_IF(B3:B10, A3:A10, “apple”) - First value in B3:B10 where A3:A10 is “apple”.
  • VALUE_IF(B3:B10, A3:A10, “apple”, D3:D10, ‘1/1/24’..‘1/31/24’) - First value in B3:B10 where A3:A10 is “apple” and D3:D10 is within January 2024.