Accéder au contenu principal

weekname - fonction de script et fonction de graphique

Cette fonction renvoie une valeur affichant l'année et le numéro de la semaine avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour de la semaine contenant l'argument date.

 

WeekName(date[, period_no[,first_week_day]])

La fonction weekname() détermine la semaine dans laquelle la date tombe et renvoie le numéro de semaine et l'année de cette semaine. Le premier jour de la semaine est déterminé par la variable système FirstWeekDay. Cependant, vous pouvez également modifier le premier jour de la semaine en utilisant l'argument first_week_day dans la fonction weekname().

Par défaut, les applications Qlik Sense utilisent des semaines interrompues (définies par la variable système BrokenWeeks ) et, par conséquent, le décompte des numéros de semaine commence le 1er janvier et se termine le jour précédant la variable système FirsWeekDay, quel que soit le nombre de jours écoulés.

Diagramme de la fonction weekname.

Diagramme montrant une plage d'années et de semaines pouvant être définie par la fonction weekname.

Cependant, si votre application utilise des semaines ininterrompues, la semaine 1 peut commencer l'année précédente ou les premiers jours de janvier. Cela dépend de la façon dont vous utilisez les variables système ReferenceDay et FirstWeekDay.

La fonction weekname() est utile lorsque vous souhaitez comparer des agrégations par semaines.

Par exemple, si vous souhaitez voir les ventes totales de produits par semaine. Pour maintenir la cohérence avec la variable système BrokenWeeks dans l'application, utilisez weekname() au lieu de lunarweekname(). Si l'application utilise des semaines ininterrompues, la semaine 1 peut contenir des dates de décembre de l'année précédente ou exclure des dates de janvier de l'année en cours. Si l'application utilise des semaines interrompues, la semaine 1 peut contenir moins de sept jours.

double

Arguments
Argument Description
date Date à évaluer.
period_no shift est un entier, où la valeur 0 indique la semaine comprenant l'argument date. Les valeurs négatives spécifiées pour shift indiquent les semaines passées tandis que les valeurs positives désignent les semaines à venir.
first_week_day

Spécifie le jour où débute la semaine. S'il est omis, c'est la valeur de la variable FirstWeekDay qui est utilisée.

FirstWeekDay

Vous pouvez utiliser les valeurs suivantes pour définir le premier jour de la semaine dans l'argument first_week_day :

first_week_day values
Jour Valeur
Lundi 0
Mardi 1
Mercredi 2
Jeudi 3
Vendredi 4
Samedi 5
Dimanche 6

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.

Exemples de fonction
Exemple Résultat
weekname('01/12/2013') Renvoie 2013/02.
weekname('01/12/2013', -1) Renvoie 2013/01.
weekname('01/12/2013', 0, 1) Renvoie 2013/02.

Exemple 1 – date sans aucun argument supplémentaire

Exemple 2 – period_no

Exemple 3 – first_week_day

Exemple 4 – Exemple d'objet graphique

Exemple 5 – scénario