Renvoie la valeur True si l'argument date se trouve dans la partie du mois comprenant l'argument basedate jusqu'à la dernière milliseconde spécifiée dans basedate.
InMonthToDate (timestamp, base_date, period_no)
booléen
Diagramme de la fonction inmonthtodate.
La fonction inmonthtodate() identifie un mois sélectionné comme segment. La limite de début est le début du mois. La limite de fin peut être définie sur une date ultérieure au cours du mois. Il est ensuite déterminé si un ensemble de dates tombent dans ce segment ou non, renvoyant une valeur booléenne TRUE ou FALSE.
| Argument | Description |
|---|---|
| timestamp | Date à comparer à base_date. |
| base_date | Date utilisée pour évaluer le mois. |
| period_no |
Il est possible de décaler le mois à l'aide de l'argument period_no. period_no est un entier, où la valeur 0 indique le mois comprenant l'argument base_date. Les valeurs négatives spécifiées pour period_no indiquent les mois passés tandis que les valeurs positives désignent les mois à venir. |
Cas d'utilisation
La fonction inmonthtodate() renvoie un résultat booléen. Ce type de fonction est généralement utilisé comme condition dans une if expression. La fonction inmonthtodate() renvoie une agrégation ou un calcul qui dépend du fait qu'une date s'est produite ou non au cours du mois jusqu'à la date en question incluse.
Par exemple, la fonction inmonthtodate() peut être utilisée pour identifier l'ensemble des équipements fabriqués au cours d'un mois jusqu'à une date spécifique.
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.
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 sur lequel 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'interface utilisateur Qlik Sense. Qlik Sense sera affiché dans la même langue que celle du navigateur que vous utilisez.
| Exemple | Résultat |
|---|---|
| inmonthtodate ('01/25/2013', '25/01/2013', 0) | Renvoie True. |
| inmonthtodate ('01/25/2013', '24/01/2013', 0) | Renvoie False. |
| inmonthtodate ('01/25/2013', '28/02/2013', -1) | 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 :
Un ensemble de données contenant un ensemble de transactions pour 2022 est chargé dans une table appelée ‘Transactions’.
Un champ date est fourni dans la variable système DateFormat au format (MM/DD/YYYY).
Instruction preceding load contenant les éléments suivants :
La fonction inmonthtodate() définie comme le champ ‘in_month_to_date’. Cela détermine les transactions qui ont eu lieu entre le 1er juillet et le 26 juillet 2022.
Script de chargement
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthtodate(date,'07/26/2022', 0) as in_month_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_month_to_date
| date | in_month_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 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | -1 |
| 7/22/2022 | -1 |
| 7/23/2022 | -1 |
| 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_month_to_date’ est créé dans l'instruction preceding load à l'aide de la fonction inmonthtodate().
Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur, le 26 juillet, qui est la base_date. Cet argument base_date identifie le mois segmenté et la limite de fin de ce segment.
Un argument period_no égal à 0 constitue l'argument final, ce qui signifie que la fonction ne compare pas les mois précédant ou suivant le mois segmenté.
Diagramme de la fonction inmonthtodate sans argument supplémentaire.
En conséquence, toute transaction qui se produit entre le 1er juillet et le 26 juillet renvoie un résultat booléen TRUE. Toute transaction qui se produit en juillet après le 26 juillet renvoie un résultat booléen FALSE, comme toute transaction de tout autre mois de l'année.
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.
Dans cet exemple, la tâche consiste à créer un champ, ‘six_months_prior’, qui détermine les transactions qui ont eu lieu un semestre complet avant le 1er juillet et le 26 juillet.
Script de chargement
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthtodate(date,'07/26/2022', -6) as six_months_prior
;
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
six_months_prior
| date | six_months_prior |
|---|---|
| 1/7/2022 | -1 |
| 1/19/2022 | -1 |
| 2/5/2022 | 0 |
| 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 -6 comme argument period_no dans la fonction inmonthtodate(), les limites du segment mensuel de comparaison sont décalées de six mois. Initialement, le segment mensuel va du 1er juillet au 26 juillet. L'argument period_no décale alors ce segment de six mois négatifs et les limites de dates sont décalées et tombent entre le 1er janvier et le 26 janvier.
Diagramme de la fonction inmonthtodate avec l'argument period_no défini sur -6.
En conséquence, toute transaction qui se produit entre le 1er janvier et le 26 janvier renverra un résultat booléen TRUE.
Exemple 3 - exemple 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 entre le 1er juillet et le 26 juillet 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 entre le 1er juillet et le 26 juillet, créez la mesure suivante :
=inmonthtodate(date,'07/26/2022', 0)
| date | =inmonthtodate(date,'07/26/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 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | -1 |
| 7/22/2022 | -1 |
| 7/23/2022 | -1 |
| 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 du champ ‘in_month_to_date’ est créée dans le graphique à l'aide de la fonction inmonthtodate().
Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur, le 26 juillet, qui est la base_date. Cet argument base_date identifie le mois segmenté et la limite de fin de ce segment. Le dernier argument est un argument period_no défini sur 0. Cela signifie que la fonction ne compare pas les mois précédant ou suivant le mois segmenté.
Diagramme de la fonction inmonthtodate sans argument supplémentaire.
En conséquence, toute transaction qui se produit entre le 1er juillet et le 26 juillet renvoie un résultat booléen TRUE. Toute transaction qui se produit en juillet après le 26 juillet renvoie un résultat booléen FALSE, comme toute transaction de tout autre mois de l'année.