# First — funkcja wykresu

Funkcja First() zwraca wartość wyrażenia obliczoną na podstawie wartości wymiaru tabeli przestawnej występujących w pierwszej kolumnie bieżącego segmentu wierszy tabeli przestawnej. Ta funkcja zwraca wartość NULL we wszystkich typach wykresów z wyjątkiem tabel przestawnych.

InformacjaSortowanie według wartości Y w wykresach albo sortowanie według kolumn wyrażeń w tabelach jest niedozwolone, gdy w dowolnym z wyrażeń wykresu stosowana jest ta funkcja wykresu. W takiej sytuacji te opcje sortowania są automatycznie wyłączone. Kiedy używasz tej funkcji wykresu w wizualizacji albo tabeli, sortowanie wizualizacji zostanie przywrócone do sortowania danych wejściowych tej funkcji.

Składnia:

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

Argumenty:

Argumenty

| Argument | Opis |
| --- | --- |
| expression | Wyrażenie lub pole zawierające mierzone dane. |
| offset | Określenie wartości offsetn większej niż 1 umożliwia przeniesienie oceny wyrażenia o n wierszy w prawo od bieżącego wiersza.<br><br>Podanie argumentu offset równego 0 spowoduje ocenę wartości wyrażenia w bieżącym wierszu.<br><br>Określenie ujemnej wartości argumentu offset sprawia, że funkcja First działa tak samo jak funkcja Last z odpowiednią dodatnią wartością argumentu offset. |
| count | Jeśli trzeci parametr count będzie większy od 1, funkcja zwróci zakres wartości, po jednej dla każdego z wierszy tabeli do wartości count, liczonych w prawo od pierwotnej komórki. |
| TOTAL | Jeśli tabela jest jednowymiarowa lub jako argument zostanie podany kwalifikator TOTAL, bieżący segment kolumny jest zawsze równy całej kolumnie.<br><br>[Określenie zakresu agregacji](https://help.qlik.com/pl-PL/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

Jeśli tabela przestawna zawiera wiele wymiarów poziomych, wówczas bieżący segment wiersza będzie zawierać tylko kolumny z takimi samymi wartościami co bieżąca kolumna we wszystkich wierszach wymiaru, z wyjątkiem wiersza przedstawiającego ostatni wymiar poziomy w kolejności sortowania między polami. Kolejność sortowania między polami dla wymiarów poziomych w tabelach przestawnych jest zdefiniowana przez kolejność wymiarów od góry do dołu..

Przykłady:

`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.