FIRST

Applies to: Calculated column Calculated table Measure Visual calculation

Used in visual calculations only. Retrieves a value in the visual matrix from the first element of an axis.

Syntax

FIRST ( <column>[, <axis>][, <blanks>][, reset] )

Parameters

Term Definition
column The column to be retrieved.
axis (Optional) An axis reference. If omitted, the first axis of the Visual Shape definition is used.
blanks (Optional) An enumeration that defines how to handle blank values when sorting.
The supported values are:
  • DEFAULT (the default value), where the behavior for numerical values is blank values are ordered between zero and negative values. The behavior for strings is blank values are ordered before all strings, including empty strings.
  • FIRST, blanks are always ordered on the beginning, regardless of ascending or descending sorting order.
  • LAST, blanks are always ordered on the end, regardless of ascending or descending sorting order.
reset (Optional) Specifies how the calculation restarts. Valid values are: None, LowestParent, HighestParent, or an integer. None is the default value.

Return value

The value of <column> from the first element of the axis.

Remarks

This function can only be used in a visual calculation.

Example

The following visual calculation returns the sales amount of the first row on ROWS axis, that resets on the lowest parent.

FirstInternetSalesAmount = FIRST ( [Sum of SalesAmount], ROWS, LowestParent )

The screenshot below shows the visual matrix and the visual calculation expression:

DAX visual calculation

LAST
PREVIOUS
NEXT