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

weekstart - fonction de script et fonction de graphique

Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du premier jour de la semaine calendaire contenant l'argument date. Le format de sortie par défaut correspond au format de date DateFormat défini dans le script.

 

WeekStart(timestamp [, period_no [, first_week_day ]])

double

La fonction weekstart() détermine la semaine au cours de laquelle tombe la date. Elle renvoie ensuite un horodatage, au format date, pour la première milliseconde de cette semaine-là. Le premier jour de la semaine est déterminé par la variable d'environnement FirstWeekDay. Cependant, cela peut être remplacé par l'argument first_week_day dans la fonction weekstart().

Arguments
Argument Description
timestamp Date ou horodatage à é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.

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.

Cas d'utilisation

La fonction weekstart() est couramment utilisée dans le cadre d'une expression lorsque l'utilisateur souhaite que le calcul utilise la fraction de la semaine qui s'est écoulée jusqu'à présent. Par exemple, cela peut permettre à un utilisateur de calculer le total des salaires touchés par les employés au cours de la semaine jusqu'à ce jour.

Les exemples suivants supposent :

SET FirstWeekDay=0;
Exemples de fonction
Exemple Résultat
weekstart('01/12/2013') Renvoie 01/07/2013.
weekstart('01/12/2013', -1 ) Renvoie 11/31/2012.
weekstart('01/12/2013', 0, 1) Renvoie 01/08/2013.

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.

 

Si vous souhaitez utiliser des paramètres ISO pour les semaines et les numéros de semaine, assurez-vous que votre script comporte les éléments suivants :

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

Si vous souhaitez utiliser des paramètres US, assurez-vous que votre script comporte les éléments suivants :

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

Les exemples ci-dessus aboutissent au résultat suivant via la fonction weekstart() :

Exemple de fonction Weekstart
Date Début de semaine ISO Début de semaine US
Sat 2020 Dec 26 2020-12-21 12/20/2020
Sun 2020 Dec 27 2020-12-21 12/27/2020
Mon 2020 Dec 28 2020-12-28 12/27/2020
Tue 2020 Dec 29 2020-12-28 12/27/2020
Wed 2020 Dec 30 2020-12-28 12/27/2020
Thu 2020 Dec 31 2020-12-28 12/27/2020
Fri 2021 Jan 1 2020-12-28 12/27/2020
Sat 2021 Jan 2 2020-12-28 12/27/2020
Sun 2021 Jan 3 2020-12-28 1/3/2021
Mon 2021 Jan 4 2021-01-04 1/3/2021
Tue 2021 Jan 5 2021-01-04 1/3/2021
Note InformationsLes débuts de semaine sont les lundis dans la colonne ISO et les dimanches dans la colonne US.

Exemple 1 – 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 !