Edit

Share via

PERMUT

  • Article

Applies to: Calculated column Calculated table Measure Visual calculation

Returns the number of permutations for a given number of objects that can be selected from number objects. A permutation is any set or subset of objects or events where internal order is significant. Permutations are different from combinations, for which the internal order is not significant. Use this function for lottery-style probability calculations.

Syntax

PERMUT(number, number_chosen)

Parameters

Term Definition
number Required. An integer that describes the number of objects.
number_chosen Required. An integer that describes the number of objects in each permutation.

Return value

Returns the number of permutations for a given number of objects that can be selected from number objects

Remarks

  • Both arguments are truncated to integers.

  • If number or number_chosen is nonnumeric, PERMUT returns the #VALUE! error value.

  • If number ≤ 0 or if number_chosen < 0, PERMUT returns the #NUM! error value.

  • If number < number_chosen, PERMUT returns the #NUM! error value.

  • The equation for the number of permutations is:

    $$P_{k,n} = \frac{n!}{(n-k)!}$$

  • This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Example

In the following formula, permutations possible for a group of 3 objects where 2 are chosen:

= PERMUT(3,2)

Result,

6