Top() 用于评估表格中列段数据第一（顶部）行的表达式。要计算的行取决于 offset 值，如果存在，则默认计算顶行。对于除表格以外的图表，Top() 用于计算图表的等效垂直表中当前列的第一行的值。
语法：
Top([TOTAL] expr [ , offset [,count ]])
返回数据类型： 双
参数：
| 参数 | 说明 |
|---|---|
| expr | 表达式或字段包含要度量的数据。 |
| offset |
指定 offset n 大于 1 后，将表达式评估向下移到顶行下面的 n 行。 指定负偏移量数值后，使 Top 函数效果类似于具有相应正偏移量数值的 Bottom 函数。 |
| count | 通过指定第三个参数 count 大于 1，函数将返回一连串 count 值，每个值对应当前列段数据的最后一个 count 行中的一行。 此时，可以将该函数用作任何特殊范围函数的参数。 范围函数 |
| TOTAL |
如果表格是单维度或如果将 TOTAL 限定符用作参数，则当前列段数据总是与整列相等。 |
限制：
-
递归调用将返回 NULL 值。
-
当在图表的任何表达式中使用此图表函数时，不允许对图表中的 y 值进行排序或按表中的表达式列进行排序。因此，这些排序替代项会自动禁用。当您在可视化或表格中使用此图表函数时，可视化的排序将返回到此函数的排序输入。
示例和结果：
示例： 1
在此示例中显示的表格的屏幕截图中，表格可视化内容通过维度 Customer 和以下度量进行创建：Sum(Sales) 和 Top(Sum(Sales))。
全部行的 Top(Sum(Sales)) 列均返回 587，因为此值是顶行值：Astrida。
此表格还显示了更复杂的度量：根据 Sum(Sales)+Top(Sum(Sales)) 创建的一个值以及标有 Top offset 3 的一个值，后者使用表达式 Sum(Sales)+Top(Sum(Sales), 3) 创建，且具有设置为 offset 的参数 3。它将当前行的 Sum(Sales) 值添加到从顶行开始第三行中的值中，即，当前行加上 Canutility 的值。
示例： 2
在此示例中显示的表格的屏幕截图中，已将更多维度添加到可视化内容中：Month 和 Product。 对于包含多个维度的图表，表达式（包含 Above、Below、Top 和 Bottom 函数）的结果取决于 Qlik Sense 对列维度进行排序的顺序。Qlik Sense 根据最后排序的维度得出的列段数据计数函数的值。可以在排序下的属性面板中控制列排序顺序，并且列不一定按顺序显示在表格中。
有关更多信息，请参阅 Above 函数中的示例：2。
|
示例： 3 |
结果 | ||
|---|---|---|---|
|
Top 函数可用作范围函数的输入。例如：RangeAvg (Top(Sum(Sales),1,3))。 |
在 Top() 函数的参数中，将 offset 设置为 1，并将 count 设置为 3。函数在列段数据中底行下方的行开始的三行上查找表达式 Sum(Sales) 的结果（因为 offset=1），并且列段数据（其中有一行）下方有两行。这三个值用作 RangeAvg() 函数的输入，用于查找所提供的数字范围中的平均值。 以 Customer 为维度的表格为 RangeAvg() 表达式提供了以下结果。 |
||
|