# class Função de script e de gráfico

A função class atribui o primeiro parâmetro a um intervalo de classe. O resultado é um valor duplo com a<=x<b como o valor textual, no qual a e b são os limites superior e inferior da caixa, e o limite inferior como valor numérico.

Sintaxe:

class(expression, interval [ , label [ , offset ]])

Tipo de dados de retorno: dual

Argumentos

| Argumento | Descrição |
| --- | --- |
| interval | Um número que especifica a largura da caixa. |
| label | Uma string arbitrária que pode substituir o “x” no texto do resultado. |
| offset | Um número que pode ser usado como deslocamento do ponto de partida padrão da classificação. O ponto de partida padrão é normalmente 0. |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `class( var,10<br>					)` com `var = 23` | Retorna `20<=x<30` |
| `class( var,5,'value'<br>					)` com `var = 23` | Retorna `20<= value <25` |
| `class(<br>							var,10,'x',5<br>					)` com `var = 23` | Retorna `15<=x<25` |

Alguns dos exemplos neste tópico usam carregamentos inline. Para obter mais informações, consulte [Usando carregamentos inline para carregar dados](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/inline-loads-qs.htm).

## Exemplo - Fundamentos de class

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/class.htm)

#### Expressão de gráfico

Visão geral

É carregada uma tabela de dados que contém nomes e idades. Você deseja classificar as pessoas por faixas etárias (com um intervalo de dez anos) e fornecer uma contagem do número de pessoas em cada grupo.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `Age`

  * `Name`

Script de carregamento

```
Example:
LOAD * INLINE [
Age, Name
25, John
42, Karen
53, Yoshi
43, Bob
27, Charles
];
```

Resultados

1. Carregue os dados e abra uma pasta. Crie duas novas tabelas.

2. Na primeira tabela, faça o seguinte:

   1. Adicione estas dimensões:

      * `Age`

      * `Name`

   2. Crie a seguinte medida:

      * `=class(Age, 10, 'age')`, para classificar os dados em categorias de idade.

3. Na segunda tabela, faça o seguinte:

   1. Adicione esta expressão como uma dimensão

      * `=class(Age, 10, 'age')`

   2. Crie a seguinte medida:

      * `=Count(Age)`, para contar o número de pessoas com classificação etária.

A primeira tabela mostra os dados brutos de `Name` e `Age`, e em qual categoria de idade eles estão classificados.

Tabela de resultados 1

| Name | Age | class(Age, 10, 'age') |
| --- | --- | --- |
| Bob | 43 | 40 &lt;= age &lt; 50 |
| Charles | 27 | 20 &lt;= age &lt; 30 |
| John | 25 | 20 &lt;= age &lt; 30 |
| Karen | 42 | 40 &lt;= age &lt; 50 |
| Yoshi | 53 | 50 &lt;= age &lt; 60 |

Na segunda tabela, você pode ver como os dados estão agora classificados e resumidos. Os resultados da função `class` criaram 3 categorias de idade na primeira medida. A segunda medida conta o número de pessoas em cada categoria de idade.

Tabela de resultados 2

| class(Age, 10, 'age') | Count(Age) |
| --- | --- |
| Totals | 5 |
| 20 &lt;= age &lt; 30 | 2 |
| 40 &lt;= age &lt; 50 | 2 |
| 50 &lt;= age &lt; 60 | 1 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/class.htm)

#### Script de carregamento

Visão geral

É carregada uma tabela de dados que contém nomes e idades. Você deseja incluir um campo que classifique cada pessoa de acordo com um grupo de idade, com dez anos de intervalo. A tabela de origem original tem a seguinte aparência.

Tabela da fonte originalTabela da fonte original

| Name | Age |
| --- | --- |
| John | 25 |
| Karen | 42 |
| Yoshi | 53 |

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Uma instrução de LOAD anterior que usa a função class para criar um novo campo chamado `Agegroup`.

Script de carregamento

```
LOAD *,
class(Age, 10, 'age') As Agegroup;

LOAD * INLINE
[ Age, Name
25, John
42, Karen
53, Yoshi];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `Name`

* `Age`

* `Agegroup`

TabelaTabela de resultados

| Name | Age | Agegroup |
| --- | --- | --- |
| John | 25 | 20 &lt;= age &lt; 30 |
| Karen | 42 | 40 &lt;= age &lt; 50 |
| Yoshi | 53 | 50 &lt;= age &lt; 60 |

O novo campo `Agegroup` classifica cada pessoa por categoria de idade.

## Exemplo - Cenário de class

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/class.htm)

#### Expressão de gráfico

Visão geral

Uma tabela de dados é carregada contendo dados do cliente. Você deseja classificar os clientes de acordo com o número de pontos de valor vitalício ganhos e fornecer uma contagem do número de clientes em cada categoria.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `CustomerID`

  * `CustomerName`

  * `LifetimeValue`

Script de carregamento

```
Example:
Load * Inline [
CustomerID, CustomerName, LifetimeValue
1, John Doe, 12500
2, Jane Smith, 36000
3, Sam Brown, 15000
4, Lisa White, 50000
5, Tom Harris, 22000
];
```

Resultados

1. Carregue os dados e abra uma pasta. Crie duas novas tabelas.

2. Na primeira tabela, faça o seguinte:

   1. Adicione estas dimensões:

      * `CustomerID`

      * `CustomerName`

      * `LifetimeValue`

   2. Crie a seguinte dimensão calculada:

      * `=Class(LifetimeValue, 10000, 'Lifetime Value Group')`, para classificar os dados com base no campo `LifetimeValue`.

3. Na segunda tabela, faça o seguinte:

   1. Adicione esta expressão como uma dimensão

      * `=Class(LifetimeValue, 10000, 'Lifetime Value Group')`

   2. Crie a seguinte medida:

      * `=Count(CustomerID)`, para contar o número de pessoas com classificação etária.

A primeira tabela mostra os dados brutos que foram inseridos e os resultados do uso da função de classe.

Tabela de resultados 1

| CustomerID | CustomerName | LifetimeValue | Class(LifetimeValue, 10000, 'Lifetime Value Group') |
| --- | --- | --- | --- |
| 1 | John Doe | 12500 | 10000 &lt;= Lifetime Value Group &lt; 20000 |
| 2 | Jane Smith | 36000 | 30000 &lt;= Lifetime Value Group &lt; 40000 |
| 3 | Sam Brown | 15000 | 10000 &lt;= Lifetime Value Group &lt; 20000 |
| 4 | Lisa White | 50000 | 50000 &lt;= Lifetime Value Group &lt; 60000 |
| 5 | Tom Harris | 22000 | 20000 &lt;= Lifetime Value Group &lt; 30000 |

A segunda tabela mostra como os dados podem ser classificados e resumidos. Os dados são categorizados em quatro grupos usando a função `class` e, em seguida, contados para mostrar o número de clientes em cada grupo.

Tabela de resultados 2

| Class(LifetimeValue, 10000, 'Lifetime Value Group') | Count(CustomerID) |
| --- | --- |
| Totals | 5 |
| 10000 &lt;= Lifetime Value Group &lt; 20000 | 2 |
| 20000 &lt;= Lifetime Value Group &lt; 30000 | 1 |
| 30000 &lt;= Lifetime Value Group &lt; 40000 | 1 |
| 50000 &lt;= Lifetime Value Group &lt; 60000 | 1 |