# inquarter Fonction de script et de graphique

Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans le trimestre comprenant l'argument base\_date.

InQuarter (timestamp, base\_date, period\_no[, first\_month\_of\_year])

booléen

Dans Qlik Sense, la valeur booléenne true est représentée par -1 et la valeur false par 0.

Diagramme de la plage de la fonction `inquarter()`

Diagramme de la plage de la fonction `inquarter()`

Diagramme de la plage de la fonction `inquarter()`inquarter() ![Diagram that shows the range of time that the inquarter() function evaluates.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquarter-diagram1.png)

En d'autres termes, la fonction `inquarter()` divise l'année en quatre trimestres égaux entre le 1er janvier et le 31 décembre. Vous pouvez utiliser l'argument `first_month_of_year` pour modifier le mois considéré comme le premier dans votre application, et les trimestres changeront en fonction de cet argument. La `base_date` ; la fonction identifie le trimestre à utiliser comme comparateur pour la fonction. Pour finir, la fonction renvoie un résultat booléen lors de la comparaison des valeurs de date à ce segment trimestriel.

Cas d'utilisation

La fonction `inquarter()` renvoie un résultat booléen. Ce type de fonction sera généralement utilisé comme condition dans une expression `if expression`. Cela renvoie une agrégation ou un calcul qui dépend du fait qu'une date s'est produite ou non au cours du trimestre sélectionné.

Par exemple, la fonction `inquarter()` peut permettre d'identifier l'ensemble des équipements fabriqués au cours d'un segment trimestriel en fonction des dates de fabrication des équipements.

Arguments

| Argument | Description |
| --- | --- |
| timestamp | Date à comparer à base\_date. |
| base\_date | Date utilisée pour évaluer le trimestre. |
| period\_no | Il est possible de décaler le trimestre à l'aide de l'argument period\_no. period\_no est un entier, où la valeur 0 indique le trimestre comprenant l'argument base\_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. |

Vous pouvez utiliser les valeurs suivantes pour définir le premier mois de l'année dans l'argument `first_month_of_year` :

Valeurs first\_month\_of\_year

| Month | value |
| --- | --- |
| Février | 2 |
| Mars | 3 |
| Avril | 4 |
| May | 5 |
| Juin | 6 |
| Juillet | 7 |
| Août | 8 |
| Septembre | 9 |
| Octobre | 10 |
| Novembre | 11 |
| Décembre | 12 |

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

Exemples de fonction

| Exemple | Résultat |
| --- | --- |
| inquarter ('01/25/2013', '01/01/2013', 0) | Renvoie TRUE |
| inquarter ('01/25/2013', '04/01/2013', 0) | Renvoie FALSE |
| inquarter ('01/25/2013', '01/01/2013', -1) | Renvoie FALSE |
| inquarter ('12/25/2012', '01/01/2013', -1) | Renvoie TRUE |
| inquarter ('01/25/2013', '03/01/2013', 0, 3) | Renvoie FALSE |
| inquarter ('03/25/2013', '03/01/2013', 0, 3) | Renvoie TRUE |

## Exemple 1 - aucun argument supplémentaire

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

* Un jeu de données contenant un ensemble de transactions en 2022 qui est chargé dans une table appelée '`Transactions`'.

* Chargement précédent qui contient la fonction `inquarter()` définie comme le champ ‘`in_quarter`’ et qui détermine les transactions qui ont eu lieu au cours du même trimestre que celui du 15 mai 2022.

Script de chargement

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

Transactions: 
    Load 
       *, 
       inquarter (date,'05/15/2022', 0) as in_quarter 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
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`
* `in_quarter`

Table de résultats

| Date | in\_quarter |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | -1 |
| 6/15/2022 | -1 |
| 6/26/2022 | -1 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Le champ « `in_quarter` » est créé dans l'instruction LOAD précédente à l'aide de la fonction `inquarter()`. Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur du 15 mai qui identifie le trimestre à définir comme comparateur. Un argument `period_no` égal à `0` constitue l'argument final et garantit que la fonction `inquarter()` ne compare pas les trimestres précédant ou suivant le trimestre segmenté.

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()`inquarter() avec le 15 mai comme date de référence ![Diagram that shows the range of time the inquarter() function evaluates with May 15 as the base date, and the year divided into quarter segments.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquarter-example1-diagram.png)

Toute transaction qui se produit entre le 1er avril et la fin du 30 juin renvoie un résultat booléen TRUE.

## Exemple 2 - period\_no

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

* Un jeu de données contenant un ensemble de transactions en 2022 qui est chargé dans une table appelée ‘`Transactions`’.

* Chargement précédent qui contient la fonction `inquarter()` définie comme le champ ‘`previous_quarter`’, et qui détermine les transactions qui ont eu lieu au cours du trimestre précédant le trimestre du 15 mai 2022.

Script de chargement

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

Transactions: 
    Load 
       *, 
       inquarter (date,'05/15/2022', -1) as previous_qtr 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
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_qtr`

Table de résultats

| Date | previous\_qtr |
| --- | --- |
| 1/7/2022 | -1 |
| 1/19/2022 | -1 |
| 2/5/2022 | -1 |
| 2/28/2022 | -1 |
| 3/16/2022 | -1 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Avec l'utilisation de `-1` comme argument `period_no` dans la fonction `inquarter()`, les limites du trimestre de comparaison sont décalées d'un trimestre complet en arrière. Le 15 mai tombe pendant le deuxième trimestre de l'année, et, par conséquent, le segment correspond initialement au trimestre du 1er avril au 30 juin. L'argument `period_no` décale ce segment de trois mois négatifs, faisant passer les limites de date au trimestre du 1er janvier au 30 mars.

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()`inquarter() avec le 15 mai comme date de référence ![Diagram that shows the range of time the inquarter() function evaluates with May 15 as the base date, and period_no set -1, moving the date boundaries back by one quarter.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquarter-example2-diagram.png)

Par conséquent, toute transaction effectuée entre le 1er janvier et le 30 mars renverra un résultat booléen TRUE.

## Exemple 3 - first\_month\_of\_year

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

* Un jeu de données contenant un ensemble de transactions en 2022 qui est chargé dans une table appelée ‘`Transactions`’.

* Chargement précédent qui contient la fonction `inquarter()` définie comme le champ ‘`in_quarter`’ et qui détermine les transactions qui ont eu lieu au cours du même trimestre que celui du 15 mai 2022.

Cependant, dans cet exemple, la stratégie organisationnelle exige que mars soit le premier mois de l'exercice financier.

Script de chargement

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

Transactions: 
    Load 
       *, 
       inquarter (date,'05/15/2022', 0, 3) as in_quarter 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
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_qtr`

Table de résultats

| Date | previous\_qtr |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | -1 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | -1 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Si on utilise `3` comme argument `first_month_of_year` dans la fonction `inquarter()`, l'année commence le 1er mars, puis elle est divisée en trimestres. Par conséquent, les segments trimestriels sont mars-mai, juin-août, sept-nov et déc-févr. La `base_date` du 15 mai défini le trimestre mars-mai comme le trimestre de comparaison de la fonction.

Diagramme de `inquarter()` fonction avec mars défini comme le premier mois de l'année

Diagramme de `inquarter()` fonction avec mars défini comme le premier mois de l'année

Diagramme de `inquarter()`inquarter() fonction avec mars défini comme le premier mois de l'année ![Diagram that shows the range of time the inquarter() function evaluates with May 15 as the base date, March set as the first month of the year.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquarter-example3-diagram.png)

Par conséquent, toute transaction effectuée entre le 1er mars et le 31 mai renverra un résultat booléen TRUE.

## Exemple 4 - exemple objet graphique

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

* Un jeu de données contenant un ensemble de transactions en 2022 qui est chargé dans une table appelée ‘`Transactions`’.

* Chargement précédent qui contient la fonction `inquarter()` définie comme le champ ‘`in_quarter`’ et qui détermine les transactions qui ont eu lieu au cours du même trimestre que celui du 15 mai 2022.

Script de chargement

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

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
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 ce champ comme dimension :

* `date`

Créez la mesure suivante pour calculer si des transactions ont eu lieu au cours du même trimestre que celui du 15 mai :

`=inquarter(date,'05/15/2022', 0)`

Table de résultats

| Date | in\_quarter |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | -1 |
| 6/15/2022 | -1 |
| 6/26/2022 | -1 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

La mesure ‘`in_quarter`’ est créée dans le graphique à l'aide de la fonction `inquarter()`. Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur du 15 mai qui identifie le trimestre à définir comme comparateur. Un argument `period_no` égal à `0` constitue l'argument final et garantit que la fonction `inquarter()` ne compare pas les trimestres précédant ou suivant le trimestre segmenté.

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()` avec le 15 mai comme date de référence

Diagramme de la fonction `inquarter()`inquarter() avec le 15 mai comme date de référence ![Diagram that shows the range of time the inquarter() function evaluates with May 15 as the base date, and the year divided into quarter segments.](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquarter-example1-diagram.png)

Toute transaction qui se produit entre le 1er avril et la fin du 30 juin renvoie un résultat booléen TRUE.

## Exemple 5 - scénario

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquarter.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 chargé dans une table appelée ‘Products’.

* La table contient les champs suivants :

  * ID de produit

  * Type de produit

  * Date de fabrication

  * Coût

Il a été identifié que, suite à une erreur d'équipement, des produits fabriqués au cours du trimestre du 15 mai 2022 étaient défectueux. L'utilisateur final souhaite un graphique qui affiche, par nom de trimestre, l'état des produits fabriqués 'defective' (défectueux) ou 'faultless' (corrects) et le coût des produits fabriqués ce trimestre-là.

Script de chargement

```
Products: 
Load 
* 
Inline  
[ 
product_id,manufacture_date,cost_price 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
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 ce champ comme dimension :

=quartername(manufacture\_date)

Créez les mesures suivantes :

* =if(only(InQuarter(manufacture\_date,makedate(2022,05,15),0)),'Defective','Faultless'), pour identifier les produits défectueux et les produits corrects via la fonction inquarter().

* =sum(cost\_price), pour afficher la somme du coût de chaque produit.

Procédez comme suit :

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

2. Sous Aspect, désactivez Totals (Totaux).

Table de résultats

| quartername(manufacture\_date) | =if(only(InQuarter(manufacture\_date,makedate(2022,05,15),0)),'Defective','Faultless') | Sum(cost\_price) |
| --- | --- | --- |
| Jan-Mar 2022 | Faultless | 253.89 |
| Apr-Jun 2022 | Defective | 351.48 |
| Jul-Sep 2022 | Faultless | 446.31 |
| Oct-Dec 2022 | Faultless | 163.91 |

La fonction inquarter() renvoie une valeur booléenne lors de l'évaluation des dates de fabrication de chacun des produits. Pour tout produit fabriqué au cours du trimestre qui contient le 15 mai, la fonction inquarter() renvoie une valeur booléenne TRUE et identifie les produits comme ‘Defective’ (défectueux). Tout produit renvoyant une valeur FALSE, et, par conséquent, non fabriqué au cours de ce trimestre-là, est identifié comme ‘Faultless’ (correct).