inmonthstodate - fonction de script et fonction de graphique

Cette fonction permet de déterminer si un horodatage tombe dans la partie d'une période (mois, période de deux mois, trimestre, période de quatre mois ou semestre) jusqu'à la dernière milliseconde incluse spécifiée dans base_date. Il est également possible de déterminer si l'horodatage se situe dans une période passée ou future.

InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])

booléen

Diagramme montrant comment utiliser la fonction inmonthstodate pour déterminer si un horodatage tombe pendant ou dehors d'un segment temporel défini. — Diagramme de la fonction inmonthstodate.

Arguments
Argument	Description
n_months	Nombre de mois définissant la période. Entier ou expression aboutissant à un entier qui doit correspondre à l'une de ces valeurs : 1 (qui équivaut à la fonction inmonth()), 2 (période de deux mois), 3 (qui équivaut à la fonction inquarter()), 4 (période de quatre mois) ou 6 (semestre).
timestamp	Date à comparer à base_date.
base_date	Date utilisée pour évaluer la période.
period_no	Il est possible de décaler la période à l'aide de l'argument period_no, d'un entier ou d'une expression aboutissant à un entier, où la valeur 0 indique la période comprenant l'argument base_date. Les valeurs négatives spécifiées pour period_no indiquent les périodes passées tandis que les valeurs positives désignent les périodes à 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.

Dans la fonction inmonthstodate(), la base_date joue le rôle de point final du segment d'année donné dont elle fait partie.

Par exemple, si l'année était divisée en segments tertiaires et si la base_date était le 15 mai, tout horodatage entre le début du mois de janvier et la fin du mois d'avril renverrait un résultat booléen FALSE. Les dates comprises entre le 1er mai et le 15 mai renverraient TRUE. Le reste de l'année renverrait FALSE.

Diagramme montrant la plage de résultats booléens de la fonction inmonthstodate. — Diagramme de la plage de résultats booléens de la fonction inmonthstodate.

Les segments suivants de l'année sont disponibles dans la fonction en tant qu'arguments n_month.

Arguments n_month
Période	Nombre de mois
mois	1
période de deux mois	2
trimestre	3
tertile	4
semestre	6

Cas d'utilisation

La fonction inmonthstodate() renvoie un résultat booléen. Ce type de fonction est généralement utilisé comme condition dans une if expression. En utilisant la fonction inmonthstodate(), vous pouvez sélectionner la période à évaluer. Par exemple, en fournissant une variable d'entrée qui permet à l'utilisateur d'identifier les produits fabriqués au cours du mois, du trimestre ou du semestre d'une période, jusqu'à une certaine date.

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
inmonthstodate(4, '01/25/2013', '04/25/2013', 0)	Renvoie True, car la valeur de l'timestamp, 01/25/2013, est comprise dans la période de quatre mois du 01/01/2013 à la fin du 04/25/2013, qui comprend la valeur de la base_date, 04/25/2013.
inmonthstodate(4, '04/26/2013', '04/25/2006', 0)	Renvoie False, car le 04/26/2013 se trouve hors de la même période que celle indiquée dans l'exemple précédent.
inmonthstodate(4, '09/25/2005', '02/01/2006', -1)	Renvoie True, car la valeur de l'argument period_no, -1, décale la période de recherche d'une période de quatre mois en arrière (la valeur de n-months), ce qui définit la période de recherche du 01/09/2005 au 02/01/2006.
inmonthstodate(4, '04/25/2006', '06/01/2006', 0, 3)	Renvoie True, car la valeur de first_month_of_year est configurée sur 3, ce qui définit la période de recherche du 03/01/2006 au 06/01/2006 au lieu du 05/01/2006 au 06/01/2006.

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 pour 2022, chargé dans une table appelée ‘Transactions’.
Champ date dans la variable système DateFormat au format (MM/DD/YYYY).
Instruction preceding load contenant les éléments suivants :
- La fonction inmonthstodate() définie comme le champ ‘in_months_to_date’. Cela détermine les transactions qui ont eu lieu au cours du trimestre jusqu'au 15 mai 2022.

Script de chargement

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', 0) as in_months_to_date 
    ; 
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_months_to_date

Tableau de résultats
date	in_months_to_date
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	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

Le champ ‘in_months_to_date’ est créé dans l'instruction preceding load à l'aide de la fonction inmonthstodate().

Le premier argument fourni est 3, divisant l'année en segments trimestriels. Le deuxième argument identifie le champ en cours d'évaluation. Le troisième argument est une date codée en dur du 15 mai, qui est la base_date qui définit la limite de fin du segment. Le dernier argument est un argument period_no défini sur 0.

Diagramme montrant la plage de transactions identifiées comme TRUE par la fonction inmonthstodate. — Diagramme de la fonction inmonthstodate sans argument supplémentaire.

Toute transaction qui se produit entre le 1er avril et le 15 mai renvoie un résultat booléen TRUE. Les dates des transactions en dehors de cette période renvoient FALSE.

Exemple 2 – period_no

Vue d'ensemble

Le même ensemble de données et le même scénario que ceux du premier exemple sont utilisés.

Cependant, dans cet exemple, la tâche consiste à créer un champ, ‘previous_qtr_to_date’, qui détermine si les transactions ont eu lieu un trimestre avant le 15 mai.

Script de chargement

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', -1) as previous_qtr_to_date 
    ; 
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_to_date

Tableau de résultats
date	previous_qtr_to_date
1/7/2022	-1
1/19/2022	-1
2/5/2022	-1
2/28/2022	0
3/16/2022	0
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 inmonthstodate(), la fonction décale les limites du segment d'année de comparaison d'un trimestre.

Le 15 mai tombe pendant le deuxième trimestre de l'année, et, par conséquent, le segment correspond initialement à la période entre le 1er avril et le 15 mai. L'argument period_no décale ce segment de trois mois négatifs. Les limites des dates deviennent du 1er janvier au 15 février.

Diagramme montrant la plage de transactions avec l'argument period_no défini sur -1. — Diagramme de la fonction inmonthstodate avec l'argument period_no défini sur -1.

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

Exemple 3 – first_month_of_year

Vue d'ensemble

Le même ensemble de données et le même scénario que ceux du premier exemple sont utilisés.

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

Créez un champ, ‘in_months_to_date’, qui détermine les transactions qui ont eu lieu au cours du même trimestre jusqu'au 15 mai 2022.

Script de chargement

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', 0,3) as in_months_to_date 
    ; 
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_months_to_date

Tableau de résultats
date	previous_qtr_to_date
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	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

Si on utilise 3 comme argument first_month_of_year dans la fonction inmonthstodate(), la fonction commence l'année le 1er mars, puis la divise en trimestres en fonction du premier argument fourni. Par conséquent, les segments de trimestre sont les suivants :

Mars-mai
Juin-août
Sept-nov
Déc-févr

La base_date du 15 mai segmente ensuite le trimestre mars-mai en fixant sa limite de fin au 15 mai.

Diagramme montrant la plage de transactions avec le premier mois de l'année défini sur mars. — Diagramme de la fonction inmonthstodate avec mars défini comme le premier mois de l'année.

Par conséquent, toute transaction qui se produit entre le 1er mars et le 15 mai renverra un résultat booléen TRUE, tandis que les transactions avec des dates en dehors de ces limites renverront une valeur FALSE.

Exemple 4 – Exemple de graphique

Vue d'ensemble

Le même ensemble de données et le même scénario que ceux du premier exemple sont utilisés.

Dans cet exemple, l'ensemble de données est inchangé et chargé dans l'application. La tâche consiste à créer un calcul qui détermine si les transactions ont eu lieu pendant le même trimestre que celui du 15 mai sous forme de mesure dans un graphique de l'application.

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

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

=inmonthstodate(3,date,'05/15/2022', 0)

Tableau de résultats
date	=inmonthstodate(3,date,'05/15/2022', 0)
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	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

La mesure ‘in_months_to_date est créée dans le graphique à l'aide de la fonction inmonthstodate().

Diagramme montrant la plage de transactions qui renvoient une valeur booléenne TRUE. — Diagramme de la fonction inmonthstodate avec des segments trimestriels.

Toute transaction qui se produit entre le 1er avril et le 15 mai renverra un résultat booléen TRUE. Les dates des transactions en dehors de ce segment renverront FALSE.

Exemple 5 – scénario

Vue d'ensemble

Dans cet exemple, un ensemble de données est chargé dans une table nommée 'Sales'. La table contient les champs suivants :

ID de produit
Type de produit
Date de vente
Prix de vente

L'utilisateur final souhaite un graphique qui affiche, par type de produit, les produits vendus au cours de la période jusqu'au 24 décembre 2022. L'utilisateur souhaite pouvoir définir la longueur de cette période.

Script de chargement

SET vPeriod = 1; 

Products: 
Load 
* 
Inline  
[ 
product_id,product_type,sales_date,sales_price 
8188,product A,'9/19/2022',37.23 
8189,product D,'10/27/2022',17.17 
8190,product C,'10/30/2022',88.27 
8191,product B,'10/31/2022',57.42 
8192,product D,'11/16/2022',53.80 
8193,product D,'11/28/2022',82.06 
8194,product A,'12/2/2022',40.39 
8195,product B,'12/5/2022',87.21 
8196,product C,'12/15/2022',95.93 
8197,product B,'12/16/2022',45.89 
8198,product C,'12/19/2022',36.23 
8199,product D,'12/22/2022',25.66 
8200,product D,'12/23/2022',82.77 
8201,product A,'12/24/2022',69.98 
8202,product A,'12/24/2022',76.11 
8203,product B,'12/26/2022',25.12 
8204,product B,'12/27/2022',46.23 
8205,product B,'12/27/2022',84.21 
8206,product C,'12/28/2022',96.24 
8207,product D,'12/29/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille.

Au début du script de chargement, une variable, vPeriod, est créée ; elle est liée au contrôle d'entrée de variable.

Procédez comme suit :

Dans le panneau des ressources, cliquez sur Objets personnalisés.
Sélectionnez Qlik Dashboard bundle et ajoutez une Entrée de variable à votre feuille.
Saisissez un titre pour le graphique.
Sous Variable, sélectionnez vPeriod comme nom et définissez l'objet de sorte qu'il s'affiche sous forme de Liste déroulante.
Sous Valeurs, cliquez sur les valeurs Dynamiques. Saisissez les éléments suivants :
```
='1~month|2~bi-month|3~quarter|4~tertial|6~half-year'.
```
Ajoutez une nouvelle table à la feuille.
Dans le panneau des propriétés, sous Données, ajoutez product_type comme dimension.
Ajoutez l'expression suivante comme mesure :

=sum(if(inmonthstodate($(vPeriod),sales_date,makedate(2022,12,24),0),sales_price,0))
Définissez le Formatage des nombres de la mesure sur Money (Devise).

Tableau de résultats
product_type	=sum(if(inmonthstodate($(vPeriod),sales_date,makedate(2022,12,24),0),sales_price,0))
product A	$186.48
product B	$190.52
product C	$220.43
product D	$261.46

La fonction inmonthstodate() utilise l'entrée utilisateur comme argument pour définir la taille du segment de début de l'année.

La fonction transmet la date de vente de chacun des produits comme deuxième argument de la fonction inmonthstodate(). Si vous utilisez le 24 décembre comme troisième argument dans la fonction inmonthstodate(), les produits dont les dates de vente tombent pendant la période définie jusqu'au 24 décembre inclus renvoient une valeur booléenne TRUE. La fonction sum additionne les ventes de ces produits.

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