inquarter - fonction de script et fonction 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 montrant la plage temporelle évaluée par la fonction inquarter(). — Diagramme de la plage de la fonction inquarter()

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
Mois	Valeur
Février	2
Mars	3
Avril	4
Mai	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/JJ/AAAA. 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. Pour plus d'informations, voir Modification des paramètres régionaux des applications et des scripts.

Les paramètres régionaux par défaut des applications sont basés sur le profil utilisateur. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'interface utilisateur Qlik Cloud. Qlik Cloud sera affiché dans la même langue que celle du navigateur que vous utilisez.

Si vous êtes un créateur d'applications, vous pouvez définir la région par défaut des applications que vous créez. Pour plus d'informations, voir Sélection des paramètres régionaux de votre choix pour la création d'applications et de scripts dans Qlik Cloud Analytics.

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

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 :

Ensemble de données contenant un ensemble de transactions en 2022, chargé dans une table appelée ‘Transactions’.
Instruction preceding load 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

Tableau 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 preceding load à 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 montrant la plage temporelle évaluée par la fonction inquarter() avec le 15 mai comme date de référence et l'année divisée en segments trimestriels. — Diagramme de la fonction inquarter() avec le 15 mai comme date de référence

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

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 :

Ensemble de données contenant un ensemble de transactions en 2022, 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

Tableau 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 montrant la plage temporelle évaluée par la fonction inquarter() avec le 15 mai comme date de référence et l'argument period_no défini sur -1, décalant les limites de date d'un trimestre en arrière. — Diagramme de la fonction inquarter() avec le 15 mai comme date de référence

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

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 :

Ensemble de données contenant un ensemble de transactions en 2022, 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

Tableau 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 montrant la plage temporelle évaluée par la fonction inquarter() avec le 15 mai comme date de référence et mars défini comme le premier mois de l'année. — Diagramme de la fonction inquarter() avec mars défini comme le premier mois de l'année

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

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 :

Ensemble de données contenant un ensemble de transactions en 2022, 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)

Tableau 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é.

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

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 :

Ensemble de données chargé dans une table appelée ‘Products’.
La table contient les champs suivants :
- product ID
- product type
- manufacture date
- cost price

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 :

Définissez le Formatage des nombres des mesures sur Money (Devise).
Sous Aspect, désactivez Totals (Totaux).

Tableau 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).

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici