# quarter Fonction de script et de graphique

La fonction quarter renvoie un entier représentant le trimestre de la date fournie. La valeur renvoyée est comprise entre 1 et 4. La fonction peut être utilisée à la fois dans les scripts de chargement et les expressions de graphique.

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

**Type de données renvoyé :** entier

Arguments de la fonction quarterquarter

| Argument | Description |
| --- | --- |
| date | Date à évaluer. |
| first\_month\_of\_year | Si vous voulez utiliser des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans first\_month\_of\_year.<br><br>Si cette valeur n'est pas spécifiée, la valeur par défaut est 1. |

## Cas d'utilisation

La fonction quarter est utile lorsque vous souhaitez comparer des agrégations par trimestre. Par exemple, la fonction peut être utilisée si vous souhaitez voir les ventes totales de produits par trimestre. Elle peut être utilisée pour créer de nouveaux champs dans le script de chargement, ainsi que dans les dimensions calculées et les expressions d'ensemble.

Exemples de fonction

| Exemple | Résultat |
| --- | --- |
| `quarter('10/29/2026')` | Renvoie 4. |
| `quartername('10/29/2026', 3)` | Renvoie 3. |

## Paramètres régionaux

Sauf indication contraire, les exemples de cette rubrique utilisent le format de date suivant : MM/DD/YYYY. Le format de date est indiqué dans l'instruction `SET DateFormat` de votre script de chargement de données. Le format de date par défaut peut être différent dans votre système en raison de vos paramètres régionaux et d'autres facteurs. Vous pouvez modifier les formats utilisés dans les exemples ci-dessous en fonction de vos besoins. Ou vous pouvez modifier les formats utilisés dans votre script de chargement pour qu'ils correspondent à ceux de ces exemples.

Les paramètres régionaux par défaut des applications sont basés sur les paramètres système régionaux de l'ordinateur ou du serveur où Qlik Sense est installé. Si le serveur Qlik Sense auquel vous accédez est configuré sur la Suède, l'éditeur de chargement de données utilisera les paramètres régionaux suédois pour les dates, l'heure et la devise. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'Qlik Sense interface utilisateur. Qlik Sense sera affiché dans la même langue que le navigateur que vous utilisez.

## Exemple – Script de chargement

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

#### Script de chargement et résultats

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données contenant un ensemble de transactions pour 2025, chargé dans une table appelée `Transactions`.

* Champ de date fourni dans la variable système `DateFormat` au format (M/D/YYYY).

* Création de deux champs :

  * `transaction_quarter` renvoie le trimestre au cours duquel les transactions ont eu lieu.

  * `transaction_quarter_march_yearstart` renvoie le trimestre des transactions, ajusté pour définir le 1er mars comme le début de l'exercice financier.

Script de chargement

```
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
];
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

* `date`

* `transaction_quarter`

* `transaction_quarter_march_yearstart`

Tableau de résultats

| 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 |

## Exemple 2 – Expressions de graphique

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

#### Expressions de graphique

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient le même jeu de données et le même scénario que ceux du premier exemple.

Cependant, dans cet exemple, le même jeu de données est chargé dans l'application. Les calculs des trimestres de réalisation des transactions sont créés sous forme de mesures dans un objet graphique de l'application.

Script de chargement

```
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
];
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :

* `date`

Créez les mesures suivantes :

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

  Cette mesure renvoie le trimestre au cours duquel les transactions ont eu lieu.

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

  Cette mesure renvoie le trimestre des transactions, ajusté pour définir le 1er mars comme le début de l'exercice financier.

Les mesures sont créées dans l'objet graphique via la fonction `quarter()` et en transmettant le champ `date` comme arguments.

Tableau de résultats

| 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 |