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

monthsend - fonction de script et fonction de graphique

Cette fonction renvoie une valeur correspondant à l'horodatage de la derniè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. Il est également possible de rechercher l'horodatage pour la fin d'une période passée ou future. Le format de sortie par défaut correspond au format de date DateFormat défini dans le script.

 

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

double

Diagramme de la fonction monthsend.

Diagramme montrant comment utiliser la fonction monthsend pour identifier le dernier horodatage d'une période sélectionnée.
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 ou horodatage à é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.

La fonction monthsend() divise l'année en segments en fonction de l'argument n_months fourni. Elle évalue ensuite le segment dans lequel tombe chaque date fournie et renvoie la dernière milliseconde, au format date, de ce segment. La fonction peut renvoyer l'horodatage de fin de segments précédents ou suivants ainsi que 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
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 monthsend() est utilisée dans le cadre d'une expression lorsque l'utilisateur souhaite que le calcul utilise la fraction du mois qui s'est écoulée jusqu'à présent. En utilisant une variable, l'utilisateur a la possibilité de sélectionner la période de son choix. Par exemple, la fonction monthsend() peut fournir une variable d'entrée permettant à l'utilisateur de calculer le total des intérêts non encore encourus au cours du mois, du trimestre ou du semestre.

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
monthsend(4, '07/19/2013') Renvoie 08/31/2013.
monthsend(4, '10/19/2013', -1) Renvoie 08/31/2013.
monthsend(4, '10/19/2013', 0, 2) Renvoie 01/31/2014.
Car le début de l'année devient le mois numéro 2.

Exemple 1 - exemple de base

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 !