Logical Functions

This article introduces logical functions and their uses in Tableau. It also demonstrates how to create a logical calculation using an example.

Why use logical calculations

Logical calculations allow you to determine if a certain condition is true or false (boolean logic). For example, you might want to quickly see if sales for each country you distribute your merchandise to were above or below a certain threshold.

The logical calculation might look something like this:

SUM(Sales) > 1,000,000

Logical functions available in Tableau:

Function

Syntax

Description

IN <expr1> IN <expr2>

Returns TRUE if any value in <expr1> matches any value in <expr2>.

The values in <expr2> can be a set, list of literal values, or combined field.

Examples:

SUM([Cost]) IN (1000, 15, 200)

[Field] IN [SET]

AND

IF <expr1> AND <expr2> THEN <then> END

Performs a logical conjunction on two expressions.

Example:

IF (ATTR([Market]) = "New Business" AND SUM([Sales]) > [Emerging Threshold] )THEN "Well Performing"

CASE CASE <expression> WHEN <value1> THEN <return1> WHEN <value2> THEN <return2> ... ELSE <default return> END

Performs logical tests and returns appropriate values. The CASE function evaluates expression, compares it to a sequence of values, value1, value2, etc., and returns a result. When a value that matches expression is encountered, CASE returns the corresponding return value. If no match is found, the default return expression is used. If there is no default return and no values match, then Null is returned.

CASE also supports WHEN IN construction, such as

CASE <expression> WHEN IN <set1> THEN <return1> WHEN IN <combinedfield> THEN <return2> ... ELSE <default> END

The values that WHEN IN compare to must be a set, list of literal values, or combined field.

Additional notes

  • CASE versus IF: CASE is often easier to use than IIF or IF THEN ELSE. Typically, an IF function performs a sequence of arbitrary tests, and a CASE function searches for a match to an expression. But a CASE function can always be rewritten as an IF function, although the CASE function will generally be more concise.
  • CASE versus groups: Many times you can use a group to get the same results as a complicated CASE function. You may want to see which is more performant for your scenario.

Examples:

CASE [Region] WHEN 'West' THEN 1 WHEN 'East' THEN 2 ELSE 3 END

CASE LEFT(DATENAME('weekday',[Order Date]),3) WHEN 'Sun' THEN 0 WHEN 'Mon' THEN 1 WHEN 'Tue' THEN 2 WHEN 'Wed' THEN 3 WHEN 'Thu' THEN 4 WHEN 'Fri' THEN 5 WHEN 'Sat' THEN 6 END

ELSE IF <expr> THEN <then> ELSE <else> END

Tests a series of expressions returning the <then> value for the first true <expr>.

Example:

If [Profit] > 0 THEN 'Profitable' ELSE 'Loss' END

ELSEIF IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Tests a series of expressions returning the <then> value for the first true <expr>.

Example:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

END IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Tests a series of expressions returning the <then> value for the first true <expr>. Must be placed at the end of an expression.

Example:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

IF IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Tests a series of expressions returning the <then> value for the first true <expr>.

Example:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

IFNULL IFNULL(expr1, expr2)

Returns <expr1> if it is not null, otherwise returns <expr2>.

Example:

IFNULL([Profit], 0)

IIF IIF(test, then, else, [unknown])

Checks whether a condition is met, and returns one value if TRUE, another value if FALSE, and an optional third value or NULL if unknown.

Example:

IIF([Profit] > 0, 'Profit', 'Loss')

ISDATE ISDATE(string)

Returns true if a given string is a valid date.

Example:

ISDATE("2004-04-15") = True

ISNULL ISNULL(expression)

Returns true if the expression is NULL (does not contain valid data).

Example:

ISNULL([Profit])

MAX MAX(expression) or Max(expr1, expr2)

Returns the maximum of a single expression across all records or the maximum of two expressions for each record.

Example:

MAX([Sales])

MIN MIN(expression) or MIN(expr1, expr2)

Returns the minimum of an expression across all records or the minimum of two expressions for each record.

Example:

MIN([Profit])

NOT IF NOT <expr> THEN <then> END

Performs logical negation on an expression.

Example:

IF NOT [Profit] > 0 THEN "Unprofitable" END

OR IF <expr1> OR <expr2> THEN <then> END

Performs a logical disjunction on two expressions.

Example:

IF [Profit] < 0 OR [Profit] = 0 THEN "Needs Improvement" END

THEN IF <expre> THEN <then> [ELSEIF ,expr2> THEN <then2>...] [ELSE <else>] END

Tests a series of expressions returning the <then> value for the first true <expr>.

Example:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Break even' ELSE 'unprofitable' END

WHEN CASE <expr> WHEN <Value1> THEN <return1> ... [ELSE <else>] END

Finds the first <value> that matches <expr> and returns the corresponding <return>.

Example:

CASE [RomanNumberal] WHEN 'I' THEN 1 WHEN 'II' THEN 2 ELSE 3 END

ZN ZN(expression)

Returns <expression> if it is not null, otherwise returns zero.

Example:

ZN([Profit])


Note: some of these are actually logical operators and appear in black, not blue. For more information, see Operator syntax.

Create a logical calculation

Follow along with the steps below to learn how to create a logical calculation.

  1. In Tableau Desktop, connect to the Sample - Superstore saved data source, which comes with Tableau.

  2. Navigate to a worksheet.

  3. From the Data pane, drag State to the Rows shelf.

  4. From the Data pane, drag Category to the Rows shelf and place it to the right of State.

  5. From the Data pane, drag Sales to the Columns shelf.

  6. Select Analysis > Create Calculated Field.

  7. In the calculation editor that opens, do the following:

    • Name the calculated field, KPI.

    • Enter the following formula:

      SUM([Profit]) > 0

      This calculation quickly checks if a member is great than zero. If so, it returns true; if not, it returns false.

    • When finished, click OK.

      The new calculated field appears under Measures in the Data pane. Just like your other fields, you can use it in onr or more visualizations.

  8. From the Data pane, drag KPI to Color on the Marks card.

    You can now see which categories are losing money in each state.

See Also

Visualize Key Progress Indicators

Logic Calculations free video tutorial

Functions in Tableau

Tableau Functions (by Category)

Tableau Functions (Alphabetical)

Thanks for your feedback!