# FirstSortedValue

FirstSortedValue() では、value で指定された項目の中で sort\_weight 引数のソート結果に対応する値が返されます。rank を指定している場合は、それも考慮されます。指定された sort\_weight で複数の値が同じ rank を共有している場合、この関数は NULL を返します。

構文:

FirstSortedValue([{SetExpression}] [DISTINCT] [TOTAL [&lt;fld {,fld}&gt;]] value, sort\_weight [,rank])

戻り値データ型： デュアル

引数：

* value: 出力フィールド。 この関数は、数式 value の値を特定します。これは sort\_weight のソート結果に対応します。

* sort\_weight: 入力フィールド。 ソート対象となるデータが含まれている数式です。sort\_weight の最初の値 (最小値) が返され、そこから value 数式の対応する値が特定されます。sort\_weight の前にマイナス記号を付けると、最後にソートされた値 (最大値) が返されます。

* rank: rank "n" に 1 よりも大きな値を入力するとで、n 番目のソート値を取得できます。

* SetExpression: デフォルトでは、集計関数は選択されたレコード セットに対して集計を行います。Set 分析数式でレコード セットを定義することも可能です。

* DISTINCT: 関数の引数の前に DISTINCT という用語が付いている場合、関数の引数の評価から生じる重複は無視されます。

* TOTAL: 関数の引数の前に TOTAL の文字が配置されている場合、現在の軸の値に関連しているものだけでなく、現在の選択範囲内にあるすべての可能な値に対して計算が実行されます。つまりチャート軸は無視されます。 TOTAL 修飾子の後には、山括弧 &lt;fld&gt; で囲んだ 1 つ以上の項目名のリストを続けることができます。これらの項目名は、チャート軸の変数のサブセットにする必要があります。

  [集計範囲の定義](https://help.qlik.com/ja-JP/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

例と結果

| 例 | 結果 |
| --- | --- |
| `firstsortedvalue (Product, UnitPrice)` | BB (最小 `UnitPrice` (9) の `Product`)。 |
| `firstsortedvalue (Product, UnitPrice, 2)` | BB (`UnitPrice` (10) が 2 番目に低い `Product`)。 |
| `firstsortedvalue (Customer, -UnitPrice, 2)` | Betacab (`UnitPrice` (20) が 2 番目に高い `Product` に関連付けられている `Customer`)。 |
| `firstsortedvalue (Customer, UnitPrice, 3)` | NULL (`UnitPrice` (15) の rank が同じ (最下位から 3 番目) `Customer` の値が 2 つ (Astrida と Canutility) あるため)。<br><br>予期しない NULL が返ってこないよう、distinct 修飾子を使います。 |
| `firstsortedvalue (Customer, -UnitPrice*UnitSales, 2)` | Canutility (`UnitPrice` と `UnitSales` (120) を掛けた販売注文値が 2 番目に高い `Customer`)。 |

**例で使用されているデータ:**

`ProductData:` `LOAD * inline [` `Customer|Product|UnitSales|UnitPrice` `Astrida|AA|4|16` `Astrida|AA|10|15` `Astrida|BB|9|9` `Betacab|BB|5|10` `Betacab|CC|2|20` `Betacab|DD||25` `Canutility|AA|8|15` `Canutility|CC||19` `] (delimiter is '|');`

テーブル形式のデータ例

| Customer | Product | UnitSales | UnitPrice |
| --- | --- | --- | --- |
| Astrida | AA | 4 | 16 |
| Astrida | AA | 10 | 15 |
| Astrida | BB | 9 | 9 |
| Betacab | BB | 5 | 10 |
| Betacab | CC | 2 | 20 |
| Betacab | DD | - | 25 |
| Canutility | AA | 8 | 15 |
| Canutility | CC | - | 19 |

## 詳細を見る

* [set 分析および set 数式](https://help.qlik.com/ja-JP/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)
* [集計範囲の定義](https://help.qlik.com/ja-JP/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)