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
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.
Les segments suivants de l'année sont disponibles dans la fonction en tant qu'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.
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 |
---|---|
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. |