Accéder au contenu principal

monthsname - fonction de script et fonction de graphique

Cette fonction renvoie une valeur d'affichage représentant la plage des mois de la période (formatée d'après la variable de script MonthNames) de même que l'année. La valeur numérique sous-jacente correspond à un horodatage de la première milliseconde du mois, de la période de deux mois, du trimestre, de la période de quatre mois ou du semestre contenant une date de référence.

 

MonthsName(n_months, date[, period_no[, first_month_of_year]])

double

Diagramme de la fonction monthsname

Exemple de diagramme montrant la plage de mois renvoyée par la fonction monthsname, en fonction d'une date d'entrée spécifique.

La fonction monthsname() divise l'année en segments en fonction de l'argument n_months fourni. Elle évalue ensuite le segment auquel appartient chaque valeur date fournie et renvoie les noms de mois de début et de fin de ce segment, ainsi que l'année. La fonction permet également de renvoyer ces limites à partir des segments précédents ou suivants, ainsi que de redéfinir le premier mois de l'année.

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

Arguments n_month possibles
Périodes Nombre de mois
mois 1
période de deux mois 2
trimestre 3
période de quatre mois

4

semestre 6
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).
date Date à évaluer.
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.

Cas d'utilisation

La fonction monthsname() est utile lorsque vous souhaitez permettre à l'utilisateur de comparer des agrégations en fonction d'une période de son choix. Par exemple, vous pouvez fournir une variable d'entrée pour permettre à l'utilisateur de voir les ventes totales de produits par mois, trimestre ou semestre.

Ces dimensions peuvent être créées soit dans le script de chargement, en ajoutant la fonction sous forme de champ dans une table Master Calendar, soit en créant la dimension directement dans un graphique sous forme de dimension calculée.

Exemples de fonction
Exemple Résultat
monthsname(4, '10/19/2013') Renvoie 'Sep-Dec 2013'. Dans cet exemple et dans les autres, l'instruction SET Monthnames est définie sur Jan;Feb;Mar, etc.
monthsname(4, '10/19/2013', -1) Renvoie 'May-Aug 2013'.
monthsname(4, '10/19/2013', 0, 2) Renvoie 'Oct-Jan 2014', car l'année est indiquée comme commençant le mois 2. Par conséquent, la période de quatre mois se termine le premier mois de l'année suivante.

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 d'une application.

Les paramètres régionaux par défaut des applications sont basés sur une combinaison de paramètres de fournisseur d'identité, de paramètres système ou de paramètres de navigateur. 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.

Exemple 1 – exemple de base

Exemple 2 – period_no

Exemple 3 – first_month_of_year

Exemple 4 – Exemple d'objet graphique

Exemple 5 – scénario