# First

Функция First() возвращает значение выражения, оцененного со значениями измерения сводной таблицы по мере их отображения в первом столбце текущего сегмента строки сводной таблицы. Данная функция возвращает значение NULL во всех типах диаграмм, кроме сводных таблиц.

Синтаксис:

first([ total ] expression [ , offset [,n ]])

Аргументы:

* expression: Выражение или поле, содержащее данные для измерения.

* offset: Если задать значение offset n больше 0, можно будет переместить оценку выражения n по строкам выше текущей строки. Если задать смещение равным 0, оценка выражения будет выполнена в текущей строке. Если задать отрицательное число смещения, функция Above будет работать как функция Below с соответствующим положительным числом смещения.

* n: Если задать для третьего параметра n значение больше 1, функция вернет диапазон значений элемента n, по одному для каждой строки таблицы элемента n, считая вправо от исходной ячейки.

* TOTAL: Если таблица имеет одно измерение, или если в качестве аргумента используется префикс TOTAL, текущий сегмент столбца всегда равен всему столбцу.

  [Определение объема агрегирования](https://help.qlik.com/ru-RU/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

Примечание к информацииСортировка по значениям y на диаграммах или сортировка по столбцам выражений в таблицах не допускается, если в любом из выражений диаграммы используется эта функция диаграмм. Данные возможности сортировки автоматически отключаются. Когда используется эта функция диаграмм в визуализации или таблице, сортировка визуализации будет возвращена к сортировке на входе этой функции.

Если сводная таблица имеет несколько горизонтальных измерений, текущий сегмент строки будет включать только столбцы с теми же значениями, что и текущий столбец во всех строках с измерениями, кроме строки с последним горизонтальным измерением в межполевом порядке сортировки.Межполевой порядок сортировки для горизонтальных измерений в сводных таблицах определяется просто по порядку измерений сверху вниз.

Примеры:

`first( sum( 
 Sales ))` `first( sum( 
 Sales ), 2 )` `first( total 
 sum( Sales )`

`rangeavg 
 (first(sum(x),1,5))` возвращает средний из результатов функции sum(x), оцененной в пяти самых левых столбцах текущего сегмента строки.