# quartername Fonction de script et de graphique

Cette fonction renvoie une valeur d'affichage présentant les mois du trimestre (formatés selon la variable de script MonthNames) et l'année avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour du trimestre.

QuarterName(date[, period\_no[, first\_month\_of\_year]])

double

Diagramme de la fonction `quartername()`

Diagramme de la fonction `quartername()`

Diagramme de la fonction `quartername()`quartername() ![Exemple de diagramme montrant comment la fonction quartername convertit une date d'entrée en plage de mois contenus dans le trimestre au cours de laquelle la date se produit.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

La fonction `quartername()` détermine le trimestre dans lequel tombe la date. Elle renvoie ensuite une valeur indiquant les mois de début et de fin de ce trimestre ainsi que l'année. La valeur numérique sous-jacente de ce résultat est la première milliseconde du trimestre.

Arguments

| Argument | Description |
| --- | --- |
| date | Date ou horodatage à évaluer. |
| period\_no | period\_no est un entier, où la valeur 0 indique le trimestre comprenant l'argument date. Les valeurs négatives de l'argument period\_no indiquent les trimestres passés tandis que les valeurs positives désignent les trimestres à venir. |
| 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 l'argument first\_month\_of\_year. |

## Cas d'utilisation

La fonction `quartername()` est utile lorsque vous souhaitez comparer des agrégations par trimestre. Par exemple, si vous souhaitez voir les ventes totales de produits par trimestre.

Cette fonction peut être utilisée dans le script de chargement pour créer un champ dans une table Master Calendar. Sinon, elle peut également être directement utilisée dans un graphique comme dimension calculée.

Ces exemples utilisent le format de date MM/DD/YYYY. Le format de date est indiqué dans l'instruction `SET DateFormat` située en haut de votre script de chargement de données. Modifiez le format utilisé dans les exemples en fonction de vos exigences.

Exemples de fonction

| Exemple | Résultat |
| --- | --- |
| `quartername('10/29/2013')` | Renvoie Oct-Dec 2013. |
| `quartername('10/29/2013', -1)` | Renvoie Jul-Sep 2013. |
| `quartername('10/29/2013', 0, 3)` | Renvoie Sep-Nov 2013. |

## 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 1 – date sans aucun argument supplémentaire

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 2022, chargé dans une table appelée `Transactions`.

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

* Création d'un champ, `transaction_quarter`, qui renvoie le trimestre au cours duquel les transactions ont eu lieu.

Ajoutez un autre texte ici, si nécessaire, avec des listes, etc.

Script de chargement

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

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

Tableau de résultats

| date | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Jan-Mar 2022 |
| 1/19/2022 | Jan-Mar 2022 |
| 2/5/2022 | Jan-Mar 2022 |
| 2/28/2022 | Jan-Mar 2022 |
| 3/16/2022 | Jan-Mar 2022 |
| 4/1/2022 | Apr-Jun 2022 |
| 5/7/2022 | Apr-Jun 2022 |
| 5/16/2022 | Apr-Jun 2022 |
| 6/15/2022 | Apr-Jun 2022 |
| 6/26/2022 | Apr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dec 2022 |
| 10/29/2022 | Oct-Dec 2022 |

Le champ `transaction_quarter` est créé dans l'instruction preceding load via la fonction `quartername()` et en transmettant le champ date comme argument de la fonction.

La fonction `quartername()` identifie initialement le trimestre au cours duquel tombe la valeur date. Elle renvoie ensuite une valeur indiquant les mois de début et de fin de ce trimestre, ainsi que l'année.

Diagramme de la fonction `quartername()`, exemple sans argument supplémentaire

Diagramme de la fonction `quartername()`, exemple sans argument supplémentaire

Diagramme de la fonction `quartername()`quartername(), exemple sans argument supplémentaire ![Diagramme montrant comment la fonction quartername détermine la plage de mois du trimestre au cours duquel une transaction a lieu.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

La transaction 8203 a eu lieu le 8 août 2022. La fonction `quartername()` identifie que la transaction a eu lieu au cours du troisième trimestre et renvoie par conséquent Jul-Sep 2022. Les mois sont affichés dans le même format que celui de la variable système `MonthNames`.

## Exemple 2 – date avec argument period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 :

* Même jeu de données et même scénario que ceux du premier exemple.

* Création d'un champ, `previous_quarter`, qui renvoie le trimestre précédent avant la réalisation des transactions.

Script de chargement

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

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

Résultats

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

* `date`

* `previous_quarter`

Tableau de résultats

| date | previous\_quarter |
| --- | --- |
| 1/7/2022 | Oct-Dec 2021 |
| 1/19/2022 | Oct-Dec 2021 |
| 2/5/2022 | Oct-Dec 2021 |
| 2/28/2022 | Oct-Dec 2021 |
| 3/16/2022 | Oct-Dec 2021 |
| 4/1/2022 | Jan-Mar 2022 |
| 5/7/2022 | Jan-Mar 2022 |
| 5/16/2022 | Jan-Mar 2022 |
| 6/15/2022 | Jan-Mar 2022 |
| 6/26/2022 | Jan-Mar 2022 |
| 7/9/2022 | Apr-Jun 2022 |
| 7/22/2022 | Apr-Jun 2022 |
| 7/23/2022 | Apr-Jun 2022 |
| 7/27/2022 | Apr-Jun 2022 |
| 8/2/2022 | Apr-Jun 2022 |
| 8/8/2022 | Apr-Jun 2022 |
| 8/19/2022 | Apr-Jun 2022 |
| 9/26/2022 | Apr-Jun 2022 |
| 10/14/2022 | Jul-Sep 2022 |
| 10/29/2022 | Jul-Sep 2022 |

Dans cet exemple, étant donné que l'argument `period_no` égal à -1 a été utilisé comme argument de décalage dans la fonction `quartername()`, la fonction commence par identifier que les transactions ont eu lieu au cours du troisième trimestre. Elle décale ensuite d'un trimestre en arrière et renvoie une valeur indiquant les mois de début et de fin de ce trimestre, ainsi que l'année.

Diagramme de la fonction `quartername()`, exemple period\_no

Diagramme de la fonction `quartername()`, exemple period\_no

Diagramme de la fonction `quartername()`quartername(), exemple period\_no ![Diagramme montrant comment la fonction quartername détermine la plage de mois du trimestre au cours duquel une transaction a lieu.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

La transaction 8203 a eu lieu le 8 août. La fonction `quartername()` identifie que le trimestre avant la transaction était compris entre le 1er avril et le 30 juin. Par conséquent, elle renvoie Apr-Jun 2022.

## Exemple 3 – date avec argument first\_week\_day

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 à 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, nous devons définir le 1er mars comme le début de l'exercice financier.

Script de chargement

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

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

Tableau de résultats

| date | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Dec-Feb 2021 |
| 1/19/2022 | Dec-Feb 2021 |
| 2/5/2022 | Dec-Feb 2021 |
| 2/28/2022 | Dec-Feb 2021 |
| 3/16/2022 | Mar-May 2022 |
| 4/1/2022 | Mar-May 2022 |
| 5/7/2022 | Mar-May 2022 |
| 5/16/2022 | Mar-May 2022 |
| 6/15/2022 | Jun-Aug 2022 |
| 6/26/2022 | Jun-Aug 2022 |
| 7/9/2022 | Jun-Aug 2022 |
| 7/22/2022 | Jun-Aug 2022 |
| 7/23/2022 | Jun-Aug 2022 |
| 7/27/2022 | Jun-Aug 2022 |
| 8/2/2022 | Jun-Aug 2022 |
| 8/8/2022 | Jun-Aug 2022 |
| 8/19/2022 | Jun-Aug 2022 |
| 9/26/2022 | Sep-Nov 2022 |
| 10/14/2022 | Sep-Nov 2022 |
| 10/29/2022 | Sep-Nov 2022 |

Dans cet exemple, étant donné que l'argument `first_month_of_year` égal à 3 est utilisé dans la fonction `quartername()`, le début de l'année passe du 1er janvier au 1er mars. Par conséquent, les trimestres de l'année deviennent March-May, June-August, September-November et December-February.

Diagramme de la fonction `quartername()`, exemple first\_week\_day

Diagramme de la fonction `quartername()`, exemple first\_week\_day

Diagramme de la fonction `quartername()`quartername(), exemple first\_week\_day ![Diagramme montrant comment la fonction quartername détermine la plage de mois du trimestre au cours duquel une transaction a lieu.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

La transaction 8203 a eu lieu le 8 août. La fonction `quartername()` identifie que la transaction a eu lieu au cours du deuxième trimestre, entre le début du mois de juin et la fin du mois d'août. Par conséquent, elle renvoie Jun-Aug 2022.

## Exemple 4 – Exemple d'objet graphique

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

#### Script de chargement et expression 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. Le calcul qui renvoie un horodatage correspondant à la fin du trimestre de réalisation des transactions est créé sous forme de mesure dans un objet graphique de l'application.

Script de chargement

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

=quartername(date)

Tableau de résultats

| date | =quartername(date) |
| --- | --- |
| 1/7/2022 | Jan-Mar 2022 |
| 1/19/2022 | Jan-Mar 2022 |
| 2/5/2022 | Jan-Mar 2022 |
| 2/28/2022 | Jan-Mar 2022 |
| 3/16/2022 | Jan-Mar 2022 |
| 4/1/2022 | Apr-Jun 2022 |
| 5/7/2022 | Apr-Jun 2022 |
| 5/16/2022 | Apr-Jun 2022 |
| 6/15/2022 | Apr-Jun 2022 |
| 6/26/2022 | Apr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dec 2022 |
| 10/29/2022 | Oct-Dec 2022 |

La mesure transaction\_quarter est créée dans l'objet graphique via la fonction quartername() et en transmettant le champ date comme argument de la fonction.

La fonction quartername() identifie initialement le trimestre au cours duquel tombe la valeur date. Elle renvoie ensuite une valeur indiquant les mois de début et de fin de ce trimestre, ainsi que l'année.

Diagramme de la fonction quartername(), exemple objet graphique

Diagramme de la fonction quartername(), exemple objet graphique

Diagramme de la fonction quartername()quartername(), exemple objet graphique ![Diagramme montrant comment la fonction quartername détermine la plage de mois du trimestre au cours duquel une transaction a lieu.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

La transaction 8203 a eu lieu le 8 août 2022. La fonction quartername() identifie que la transaction a eu lieu au cours du troisième trimestre et renvoie par conséquent Jul-Sep 2022. Les mois sont affichés dans le même format que celui de la variable système MonthNames.

## Exemple 5 – Scénario

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

#### Script de chargement et expression de graphique

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 2022, chargé dans une table appelée Transactions.

* Champ de date fourni dans la variable système DateFormat au format (MM/DD/YYYY).

L'utilisateur final souhaite un objet graphique présentant les ventes totales par trimestre pour les transactions. Cela est possible même lorsque cette dimension n'est pas disponible dans le modèle de données, en utilisant la fonction quartername() comme dimension calculée dans le graphique.

Script de chargement

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

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

Résultats

Procédez comme suit :

1. Chargez les données et ouvrez une feuille. Créez un tableau.

2. Créez une dimension calculée à l'aide de l'expression suivante :

   =quartername(date)

3. Calculez ensuite les ventes totales via la mesure d'agrégation suivante :

   =sum(amount)

4. Définissez le Formatage des nombres des mesures sur Money (Devise).

Tableau de résultats

| =quartername(date) | =sum(amount) |
| --- | --- |
| Jul-Sep 2022 | $446.31 |
| Apr-Jun 2022 | $351.48 |
| Jan-Mar 2022 | $253.89 |
| Oct-Dec 2022 | $163.91 |