# First - 图表函数

First() 用于返回使用透视表的维度值评估的表达式值，因为维度值显示在透视表的当前行段的第一列。在除透视表之外的所有图表类型中，此函数会返回 NULL。

信息注释当在图表的任何表达式中使用此图表函数时，不允许对图表中的 y 值进行排序或按表中的表达式列进行排序。因此，这些排序替代项会自动禁用。当您在可视化或表格中使用此图表函数时，可视化的排序将返回到此函数的排序输入。

语法：

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

参数：

参数

| 参数 | 描述 |
| --- | --- |
| expression | 表达式或字段包含要度量的数据。 |
| offset | 指定 offsetn（大于 1）会将表达式评估从当前行开始向右移动 n 行。<br><br>指定 0 偏移量可以计算当前行上的表达式的值。<br><br>指定负偏移量数值后，使 First 函数效果类似于具有相应正偏移量数值的 Last 函数。 |
| count | 通过指定第三个参数 count（大于 1），函数将返回一连串值，每个值对应一个从原始单元格开始向右计数的 count 表格行。 |
| TOTAL | 如果表格是单维度或如果将 TOTAL 限定符用作参数，则当前列段数据总是与整列相等。<br><br>[定义聚合范围](https://help.qlik.com/zh-CN/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.