Accéder au contenu principal Passer au contenu complémentaire

inmonths - fonction de script et fonction de graphique

Cette fonction permet de déterminer si un horodatage tombe pendant la même période (mois, période de deux mois, trimestre, période de quatre mois ou semestre) que la date de référence. 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

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

Diagramme de la fonction inmonths()

Diagramme montrant la plage temporelle pendant laquelle la fonction inmonths() évaluera une date de référence comme true ou false.

La fonction inmonths() divise l'année en segments en fonction de l'argument n_months fourni. Elle détermine ensuite si chaque horodatage évalué tombe dans le même segment que celui de l'argument base_date. Si, toutefois, un argument period_no est fourni, la fonction détermine si les horodatages tombent pendant une période précédente ou suivante par rapport à la base_date.

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
période de quatre mois 4
semestre 6

La fonction inmonths() renvoie un résultat booléen. Ce type de fonction sera généralement utilisé comme condition dans une expression if expression. En utilisant la fonction inmonths(), vous pouvez sélectionner la période à évaluer. Par exemple, en laissant l'utilisateur identifier les produits fabriqués au cours du mois, du trimestre ou du semestre d'une période donnée.

booléen

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

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.

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
inmonths(4, '01/25/2013', '04/25/2013', 0) Renvoie TRUE. Car la valeur d'horodatage, 01/25/2013, est comprise dans la période de quatre mois du 01/01/2013 au 04/30/2013, qui comprend la valeur de base_date, 04/25/2013.
inmonths(4, '05/25/2013', '04/25/2013', 0) Renvoie FALSE. Car la date 05/25/2013 se trouve en dehors de la période indiquée dans l'exemple précédent.
inmonths(4, '11/25/2012', '02/01/2013', -1 ) Renvoie TRUE. Car la valeur de period_no, -1, décale la période de recherche de quatre mois en arrière (la valeur de n-months), ce qui définit la période de recherche du 09/01/2012 au 12/31/2012.
inmonths(4, '05/25/2006', '03/01/2006', 0, 3) Renvoie TRUE. Car la valeur de first_month_of_year est définie sur 3, ce qui définit la période de recherche du 03/01/2006 au 07/30/2006 au lieu du 01/01/2006 au 04/30/2006.

Exemple 1 - aucun argument supplémentaire

Exemple 2 - period_no

Exemple 3 - first_month_of_year

Exemple 4 - exemple objet graphique

Exemple 5 - scénario

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 !