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

A função quarter retorna um número inteiro que representa o trimestre da data fornecida. O valor retornado está entre 1 e 4. A função pode ser usada tanto em scripts de carregamento quanto em expressões de gráfico.

quarter(date [, first\_month\_of\_year])

**Tipo de dados de retorno:** inteiro

Argumentos da função quarterquarter

| Argumento | Descrição |
| --- | --- |
| date | A data para avaliar. |
| first\_month\_of\_year | Se desejar trabalhar com anos (fiscais) que não comecem em janeiro, indique um valor entre 2 e 12 em first\_month\_of\_year.<br><br>Caso não seja especificado, o valor padrão é 1. |

## Quando usar

A função quarter é útil quando você deseja comparar agregações por trimestre. Por exemplo, a função pode ser usada se você deseja ver o total de vendas de produtos por trimestre. Ela pode ser usada para criar novos campos no script de carregamento, bem como em dimensões calculadas e expressões de conjunto.

Exemplos de funções

| Exemplo | Resultado |
| --- | --- |
| `quarter('10/29/2026')` | Retorna 4. |
| `quarter('10/29/2026', 3)` | Retorna 3. |

## Configurações regionais

A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução `SET DateFormat` no seu script de carga de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos. Para obter mais informações, consulte [Modificando configurações regionais para aplicativos e scripts](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.

Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte [Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Exemplo – script de carregamento

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarter.htm)

#### Script de carregamento e resultados

Visão geral

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 contendo um conjunto de transações para 2025, que é carregado em uma tabela denominada `Transactions`.

* O campo de data fornecido no formato da `DateFormat`variável de sistema (M/D/AAAA).

* A criação de dois campos:

  * `transaction_quarter` retorna o trimestre em que as transações ocorreram.

  * `transaction_quarter_march_yearstart` retorna o trimestre das transações, ajustado para definir 1º de março como o início do ano fiscal.

Script de carregamento

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*,
quarter(date) as transaction_quarter,
quarter(date,3) as transaction_quarter_march_yearstart
;
Load
*
Inline
[
id,date,amount
8188,1/7/2025,17.17
8189,1/19/2025,37.23
8190,2/28/2025,88.27
8191,2/5/2025,57.42
8192,3/16/2025,53.80
8193,4/1/2025,82.06
8194,5/7/2025,40.39
8195,5/16/2025,87.21
8196,6/15/2025,95.93
8197,6/26/2025,45.89
8198,7/9/2025,36.23
8199,7/22/2025,25.66
8200,7/23/2025,82.77
8201,7/27/2025,69.98
8202,8/2/2025,76.11
8203,8/8/2025,25.12
8204,8/19/2025,46.23
8205,9/26/2025,84.21
8206,10/14/2025,96.24
8207,10/29/2025,67.67
];
```

Resultados

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

* `date`

* `transaction_quarter`

* `transaction_quarter_march_yearstart`

Tabela de resultados

| date | transaction\_quarter | transaction\_quarter\_march\_yearstart |
| --- | --- | --- |
| 1/7/2025 | 1 | 4 |
| 1/19/2025 | 1 | 4 |
| 2/28/2025 | 1 | 4 |
| 2/5/2025 | 1 | 4 |
| 3/16/2025 | 1 | 1 |
| 4/1/2025 | 2 | 1 |
| 5/7/2025 | 2 | 1 |
| 5/16/2025 | 2 | 1 |
| 6/15/2025 | 2 | 2 |
| 6/26/2025 | 2 | 2 |
| 7/9/2025 | 3 | 2 |
| 7/22/2025 | 3 | 2 |
| 7/23/2025 | 3 | 2 |
| 7/27/2025 | 3 | 2 |
| 8/2/2025 | 3 | 2 |
| 8/8/2025 | 3 | 2 |
| 8/19/2025 | 3 | 2 |
| 9/26/2025 | 3 | 3 |
| 10/14/2025 | 4 | 3 |
| 10/29/2025 | 4 | 3 |

## Exemplo 2 – expressões de gráfico

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarter.htm)

#### Expressões de gráfico

Visão geral

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

O script de carregamento contém o mesmo conjunto de dados e cenário do primeiro exemplo.

No entanto, neste exemplo, o conjunto de dados inalterado é carregado no aplicativo. Os cálculos dos trimestres de transação são criados como medidas em um objeto de gráfico do aplicativo.

Script de carregamento

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2025,17.17
8189,1/19/2025,37.23
8190,2/28/2025,88.27
8191,2/5/2025,57.42
8192,3/16/2025,53.80
8193,4/1/2025,82.06
8194,5/7/2025,40.39
8195,5/16/2025,87.21
8196,6/15/2025,95.93
8197,6/26/2025,45.89
8198,7/9/2025,36.23
8199,7/22/2025,25.66
8200,7/23/2025,82.77
8201,7/27/2025,69.98
8202,8/2/2025,76.11
8203,8/8/2025,25.12
8204,8/19/2025,46.23
8205,9/26/2025,84.21
8206,10/14/2025,96.24
8207,10/29/2025,67.67
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* `date`

Crie as seguintes medidas:

* ```
  =quarter(date)
  ```

  Esta medida retorna o trimestre em que as transações ocorreram.

* ```
  =quarter(date,3)
  ```

  Esta medida retorna o trimestre das transações, ajustado para definir 1º de março como o início do ano fiscal.

As medidas são criadas no objeto de gráfico usando a função `quarter()` e passando o campo `date` como argumentos.

Tabela de resultados

| date | =quarter(date) | =quarter(date,3) |
| --- | --- | --- |
| 1/7/2025 | 1 | 4 |
| 1/19/2025 | 1 | 4 |
| 2/28/2025 | 1 | 4 |
| 2/5/2025 | 1 | 4 |
| 3/16/2025 | 1 | 1 |
| 4/1/2025 | 2 | 1 |
| 5/7/2025 | 2 | 1 |
| 5/16/2025 | 2 | 1 |
| 6/15/2025 | 2 | 2 |
| 6/26/2025 | 2 | 2 |
| 7/9/2025 | 3 | 2 |
| 7/22/2025 | 3 | 2 |
| 7/23/2025 | 3 | 2 |
| 7/27/2025 | 3 | 2 |
| 8/2/2025 | 3 | 2 |
| 8/8/2025 | 3 | 2 |
| 8/19/2025 | 3 | 2 |
| 9/26/2025 | 3 | 3 |
| 10/14/2025 | 4 | 3 |
| 10/29/2025 | 4 | 3 |