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

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 [, broken_weeks [, reference_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().

 Dans Qlik Sense, les paramètres régionaux sont récupérés lorsque l'application est créée, et les paramètres correspondants sont stockés dans le script sous forme de variables d'environnement.

Un développeur d'applications nord-américain reçoit souvent Set BrokenWeeks=1; dans le script, ce qui correspond à des semaines interrompues. Un développeur d'applications européen reçoit souvent Set BrokenWeeks=0; dans le script, ce qui correspond à des semaines ininterrompues.

Si votre application utilise des semaines interrompues, le décompte des numéros de semaine commence le 1er janvier et se termine le jour précédant la variable système FirstWeekDay, quel que soit le nombre de jours écoulés.

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.

Exemple de fonction Weekname
DateNom de semaine ISONom de semaine US
Sat 2020 Dec 262020/522020/52
Sun 2020 Dec 272020/522020/53
Mon 2020 Dec 282020/532020/53
Tue 2020 Dec 292020/532020/53
Wed 2020 Dec 302020/532020/53
Thu 2020 Dec 312020/532020/53
Fri 2021 Jan 12020/532021/01
Sat 2021 Jan 22020/532021/01
Sun 2021 Jan 32020/532021/02
Mon 2021 Jan 42021/012021/02
Tue 2021 Jan 52021/012021/02

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 d'environnement 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
ArgumentDescription
timestampDate ou horodatage à évaluer.
period_noshift 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.

Les valeurs possibles de first_week_day sont 0 pour lundi, 1 pour mardi, 2 pour mercredi, 3 pour jeudi, 4 pour vendredi, 5 pour samedi et 6 pour dimanche.

Pour plus d'informations sur la variable système, voir FirstWeekDay.

broken_weeks

Si vous ne précisez pas la variable broken_weeks, la valeur de la variable BrokenWeeks sera utilisée pour définir si les semaines sont interrompues ou non.

Pour plus d'informations sur la variable système, voir BrokenWeeks.

reference_day

Si vous ne spécifiez pas reference_day, la valeur de la variable ReferenceDay sera utilisée pour spécifier le jour du mois de janvier devant être défini comme jour de référence pour définir la semaine 1. Par défaut, les fonctions Qlik Sense utilisent le 4 comme jour de référence. Cela signifie que la semaine 1 doit contenir le 4 janvier ou, en d'autres termes, que la semaine 1 doit toujours comprendre au moins 4 jours en janvier.

Pour plus d'informations sur la variable système, voir ReferenceDay.

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.

Les exemples ci-dessous supposent :

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
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

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 !