# First - チャート関数

First() は、ピボット テーブルの現在の行セグメントの最初の列に、ピボット テーブルの軸値で評価された expression の値を返します。ピボット テーブル以外のすべてのチャート タイプの場合、この関数は NULL を返します。

情報メモチャートの式いずれかにこのチャート関数が使用されている場合、チャートの y 値のソート、またはテーブルの式列ごとのソートは許可されません。よって、これらのソート機能は自動的に無効になります。ビジュアライゼーションまたはテーブルでこのチャート関数を使用すると、ビジュアライゼーションのソートは、レコード間の関数に対するソートされた入力の状態に戻ります。

構文:

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

引数：

引数

| 引数 | 説明 |
| --- | --- |
| expression | メジャーの対象となるデータが含まれている数式または項目。 |
| offset | offset n を 1 より大きい値にすると、数式の評価が現在の行から n 行右に移動します。<br><br>offset に 0 を指定すると、現在の行で数式が評価されます。<br><br>offset が負の値である場合、First 関数は、相応する正の offset 値が付いた Last 関数と同様に機能します。 |
| count | 3 番目のパラメータ count を 1 より大きい値にした場合、この関数は count 値の範囲を返します。つまり、オリジナルのテーブルのセルから右方向に count 行の各値を返します。 |
| TOTAL | テーブルが 1 軸の場合、または TOTAL 修飾子が引数として使用される場合は、現在の列セグメントは常に列全体と等しくなります。<br><br>[集計範囲の定義](https://help.qlik.com/ja-JP/sense/November2024/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))` 現在の行セグメントの左端 5 つの列で評価された sum(x) 関数の結果の平均を返します。