# First — функция диаграммы

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

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

Синтаксис:

First([TOTAL] expr [, offset [, count]])

Аргументы:

Аргументы

| Аргумент | Описание |
| --- | --- |
| expression | Выражение или поле, содержащее данные для измерения. |
| offset | Если задать значение offset n больше 1, можно переместить оценку выражения на n строк вправо от текущей строки.<br><br>Если задать смещение равным 0, оценка выражения будет выполнена в текущей строке.<br><br>Если задать отрицательное число смещения, функция First будет работать как функция Last с соответствующим положительным числом смещения. |
| count | Если задать для третьего параметра count значение больше 1, функция вернет диапазон значений элемента count, по одному для каждой строки таблицы элемента, считая вправо от исходной ячейки. |
| TOTAL | Если таблица имеет одно измерение, или если в качестве аргумента используется префикс TOTAL, текущий сегмент столбца всегда равен всему столбцу.<br><br>[Определение объема агрегирования](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

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

Примеры:

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

`rangeavg   (first(sum(x),1,5))` returns an average of the results of the sum(x) function evaluated on the five leftmost columns of the current row segment.