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

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 de la fonction inmonthstodate.

Diagramme montrant comment utiliser la fonction inmonthstodate pour déterminer si un horodatage tombe pendant ou dehors d'un segment temporel défini.
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 de la plage de résultats booléens de la fonction inmonthstodate.

Diagramme montrant 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

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.

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.

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

Exemple 2 – period_no

Exemple 3 – first_month_of_year

Exemple 4 – Exemple de 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 !