inweek - fonction de script et fonction de graphique

Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la semaine comprenant l'argument base_date.

InWeek (timestamp, base_date, period_no[, first_week_day])

booléen

Dans Qlik Sense, la valeur booléenne true est représentée par -1 et la valeur false par 0.

Diagramme montrant comment utiliser la fonction inweek() pour évaluer des dates au sein de segments hebdomadaires et renvoyer un résultat booléen si une date tombe ou non dans une plage sélectionnée. — Diagramme de la plage de la fonction inweek()

La fonction inweek() utilise l'argument base_date pour identifier la période de sept jours de la date. Le jour de début de la semaine est basé sur la variable système FirstWeekDay. Cependant, vous pouvez également modifier le premier jour de la semaine en utilisant l'argument first_week_day de la fonction inweek().

Une fois la semaine sélectionnée définie, la fonction renverra des résultats booléens lors de la comparaison des valeurs de date prescrites à ce segment hebdomadaire.

Cas d'utilisation

La fonction inweek() renvoie un résultat booléen. Ce type de fonction sera généralement utilisé comme condition dans une expression if expression. La fonction inweek() renvoie une agrégation ou un calcul qui dépend du fait qu'une date évaluée est tombée ou non pendant la semaine contenant la date sélectionnée de l'argument base_date.

Par exemple, la fonction inweek() peut être utilisée pour identifier l'ensemble des équipements fabriqués au cours d'une semaine spécifique.

Arguments
Argument	Description
timestamp	Date à comparer à base_date.
base_date	Date utilisée pour évaluer la semaine.
period_no	Il est possible de décaler la semaine à l'aide de l'argument period_no. period_no est un entier, où la valeur 0 indique la semaine comprenant l'argument base_date. Les valeurs négatives spécifiées pour period_no indiquent les semaines passées tandis que les valeurs positives désignent les semaines à venir.
first_week_day	Par défaut, le premier jour de la semaine est le dimanche (tel que déterminé par la variable système FirstWeekDay), commençant à minuit entre le samedi et le dimanche. Le paramètre first_week_day remplace la variable FirstWeekDay. Pour que la semaine commence un autre jour, spécifiez un indicateur compris entre 0 et 6.

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 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
inweek ('01/12/2006', '01/14/2006', 0)	Renvoie TRUE
inweek ('01/12/2006', '01/20/2006', 0 )	Renvoie FALSE
inweek ('01/12/2006', '01/14/2006', -1 )	Renvoie FALSE
inweek ('01/07/2006', '01/14/2006', -1)	Renvoie TRUE
inweek ('01/12/2006', '01/09/2006', 0, 3)	Renvoie FALSE, car la valeur first_week_day est spécifiée sur 3 (jeudi), ce qui fait de la date du 01/12/2006 le premier jour de la semaine suivant la semaine contenant le 01/09/2006.

Ces rubriques peuvent vous aider à utiliser cette fonction :

Rubriques connexes
Rubrique	Indicateur/valeur par défaut	Description
FirstWeekDay	6 / Dimanche	Définit le jour de début de chaque semaine.

Exemple 1 - aucun argument supplémentaire

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Ensemble de données contenant un ensemble de transactions pour le mois de janvier 2022, chargé dans une table appelée ‘Transactions’.
Variable système FirstWeekDay définie sur 6 (dimanche).
Instruction preceding load contenant les éléments suivants :
- La fonction inweek(), définie comme le champ ‘in_week’, qui détermine les transactions qui ont eu lieu au cours de la semaine du 14 janvier 2022.
- La fonction weekday(), définie comme le champ ‘week_day’, qui indique le jour de la semaine correspondant à chaque date.

Script de chargement

SET FirstWeekDay=6; 
SET DateFormat='MM/DD/YYYY'; 
 
Transactions: 
    Load 
       *, 
       weekday(date) as week_day, 
       inweek(date,'01/14/2022', 0) as in_week 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/02/2022',37.23 
8189,'01/05/2022',17.17 
8190,'01/06/2022',88.27 
8191,'01/08/2022',57.42 
8192,'01/09/2022',53.80 
8193,'01/10/2022',82.06 
8194,'01/11/2022',40.39 
8195,'01/12/2022',87.21 
8196,'01/13/2022',95.93 
8197,'01/14/2022',45.89 
8198,'01/15/2022',36.23 
8199,'01/16/2022',25.66 
8200,'01/17/2022',82.77 
8201,'01/18/2022',69.98 
8202,'01/26/2022',76.11 
8203,'01/27/2022',25.12 
8204,'01/28/2022',46.23 
8205,'01/29/2022',84.21 
8206,'01/30/2022',96.24 
8207,'01/31/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

date
week_day
in_week

Tableau de résultats
date	week_day	in_week
01/02/2022	Sun	0
01/05/2022	Wed	0
01/06/2022	Thu	0
01/08/2022	Sat	0
01/09/2022	Sun	-1
01/10/2022	Mon	-1
01/11/2022	Tue	-1
01/12/2022	Wed	-1
01/13/2022	Thu	-1
01/14/2022	Fri	-1
01/15/2022	Sat	-1
01/16/2022	Sun	0
01/17/2022	Mon	0
01/18/2022	Tue	0
01/26/2022	Wed	0
01/27/2022	Thu	0
01/28/2022	Fri	0
01/29/2022	Sat	0
01/30/2022	Sun	0
01/31/2022	Mon	0

Le champ ‘in_week’ est créé dans l'instruction preceding load à l'aide de la fonction inweek(). Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur du 14 janvier, qui est la base_date. L'argument base_date fonctionne avec la variable système FirstWeekDay pour identifier la semaine de comparaison. Un argument period_no égal à 0 — qui signifie que la fonction ne compare pas les semaines précédant ou suivant la semaine segmentée — constitue l'argument final.

La variable système FirstWeekDay détermine que les semaines commencent un dimanche et se terminent un samedi. Par conséquent, janvier serait divisé en semaines selon le diagramme ci-dessous, les dates comprises entre le 9 et le 15 janvier fournissant la période valide pour le calcul inweek() :

Diagramme d'un calendrier indiquant un mois, avec les dates du 9 au 15 surlignées en vert. La date du 9 est un dimanche et celle du 15 est un samedi. — Diagramme de calendrier avec la plage de la fonction inweek() en surbrillance

Toute transaction qui se produit entre le 9 janvier et le 15 janvier renvoie un résultat booléen TRUE.

Exemple 2 - period_no

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Le même ensemble de données contenant un ensemble de transactions pour 2022 est chargé dans une table appelée ‘Transactions’.
Variable système FirstWeekDay définie sur 6 (dimanche).
Chargement précédent contenant les éléments suivants :
- Fonction inweek (), définie comme le champ ‘prev_week’, qui détermine les transactions qui ont eu lieu une semaine complète avant la semaine du 14 janvier 2022.
- La fonction weekday(), définie comme le champ ‘week_day’, qui indique le jour de la semaine correspondant à chaque date.

Script de chargement

SET FirstWeekDay=6; 
SET DateFormat='MM/DD/YYYY'; 
 
Transactions: 
    Load 
       *, 
	weekday(date) as week_day, 
	inweek(date,'01/14/2022', -1) as prev_week  
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/02/2022',37.23 
8189,'01/05/2022',17.17 
8190,'01/06/2022',88.27 
8191,'01/08/2022',57.42 
8192,'01/09/2022',53.80 
8193,'01/10/2022',82.06 
8194,'01/11/2022',40.39 
8195,'01/12/2022',87.21 
8196,'01/13/2022',95.93 
8197,'01/14/2022',45.89 
8198,'01/15/2022',36.23 
8199,'01/16/2022',25.66 
8200,'01/17/2022',82.77 
8201,'01/18/2022',69.98 
8202,'01/26/2022',76.11 
8203,'01/27/2022',25.12 
8204,'01/28/2022',46.23 
8205,'01/29/2022',84.21 
8206,'01/30/2022',96.24 
8207,'01/31/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

date
week_day
prev_week

Tableau de résultats
date	week_day	prev_week
01/02/2022	Sun	-1
01/05/2022	Wed	-1
01/06/2022	Thu	-1
01/08/2022	Sat	-1
01/09/2022	Sun	0
01/10/2022	Mon	0
01/11/2022	Tue	0
01/12/2022	Wed	0
01/13/2022	Thu	0
01/14/2022	Fri	0
01/15/2022	Sat	0
01/16/2022	Sun	0
01/17/2022	Mon	0
01/18/2022	Tue	0
01/26/2022	Wed	0
01/27/2022	Thu	0
01/28/2022	Fri	0
01/29/2022	Sat	0
01/30/2022	Sun	0
01/31/2022	Mon	0

Si on applique la valeur -1 à l'argument period_no dans la fonction inweek(), les limites de la semaine de comparaison sont décalées de sept jours complets en arrière. Avec un argument period_no égal à 0, la semaine serait comprise entre le 9 et le 15 janvier. Mais, dans cet exemple, l'argument period_no défini sur -1 décale les limites de début et de fin de ce segment d'une semaine en arrière. Les limites des dates deviennent du 2 janvier au 8 janvier.

Diagramme d'un calendrier indiquant un mois, avec les dates du 2 au 8 surlignées en vert. La date du 2 est un dimanche et celle du 8 est un samedi. — Diagramme de calendrier avec la plage de la fonction inweek() en surbrillance

Par conséquent, toute transaction effectuée entre le 2 janvier et le 8 janvier renverra un résultat booléen TRUE.

Exemple 3 - first_week_day

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Le même ensemble de données contenant un ensemble de transactions pour 2022 est chargé dans une table appelée ‘Transactions’.
Variable système FirstWeekDay définie sur 6 (dimanche).
Chargement précédent contenant les éléments suivants :
- Fonction inweek(), définie comme le champ ‘in_week’, qui détermine les transactions qui ont eu lieu au cours de la semaine du 14 janvier 2022.
- La fonction weekday(), définie comme le champ ‘week_day’, qui indique le jour de la semaine correspondant à chaque date.

Script de chargement

SET FirstWeekDay=6; 
SET DateFormat='MM/DD/YYYY'; 
 
Transactions: 
    Load 
       *, 
	weekday(date) as week_day, 
	inweek(date,'01/14/2022', 0, 0) as in_week 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/02/2022',37.23 
8189,'01/05/2022',17.17 
8190,'01/06/2022',88.27 
8191,'01/08/2022',57.42 
8192,'01/09/2022',53.80 
8193,'01/10/2022',82.06 
8194,'01/11/2022',40.39 
8195,'01/12/2022',87.21 
8196,'01/13/2022',95.93 
8197,'01/14/2022',45.89 
8198,'01/15/2022',36.23 
8199,'01/16/2022',25.66 
8200,'01/17/2022',82.77 
8201,'01/18/2022',69.98 
8202,'01/26/2022',76.11 
8203,'01/27/2022',25.12 
8204,'01/28/2022',46.23 
8205,'01/29/2022',84.21 
8206,'01/30/2022',96.24 
8207,'01/31/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

date
week_day
in_week

Tableau de résultats
date	week_day	in_week
01/02/2022	Sun	0
01/05/2022	Wed	0
01/06/2022	Thu	0
01/08/2022	Sat	0
01/09/2022	Sun	0
01/10/2022	Mon	-1
01/11/2022	Tue	-1
01/12/2022	Wed	-1
01/13/2022	Thu	-1
01/14/2022	Fri	-1
01/15/2022	Sat	-1
01/16/2022	Sun	-1
01/17/2022	Mon	0
01/18/2022	Tue	0
01/26/2022	Wed	0
01/27/2022	Thu	0
01/28/2022	Fri	0
01/29/2022	Sat	0
01/30/2022	Sun	0
01/31/2022	Mon	0

Si on applique 0 à l'argument first_week_day dans la fonction inweek(), l'argument remplace la variable système FirstWeekDay et définit le lundi comme le premier jour de la semaine.

Diagramme d'un calendrier indiquant un mois, avec les dates du 10 au 16 surlignées en vert. La date du 10 est un lundi et celle du 16 est un dimanche. — Diagramme de calendrier avec la plage de la fonction inweek() en surbrillance

Par conséquent, toute transaction effectuée entre le 10 et le 16 janvier renverra un résultat booléen TRUE.

Exemple 4 - exemple objet graphique

Vue d'ensemble

Le même ensemble de données et le même scénario que ceux du premier exemple sont utilisés.

Cependant, dans cet exemple, l'ensemble de données est le même et chargé dans l'application. Créez une mesure dans le tableau de résultats pour déterminer les transactions qui ont eu lieu au cours de la semaine du 14 janvier 2022.

Script de chargement

SET FirstWeekDay=6; 
SET DateFormat='MM/DD/YYYY'; 
 
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/02/2022',37.23 
8189,'01/05/2022',17.17 
8190,'01/06/2022',88.27 
8191,'01/08/2022',57.42 
8192,'01/09/2022',53.80 
8193,'01/10/2022',82.06 
8194,'01/11/2022',40.39 
8195,'01/12/2022',87.21 
8196,'01/13/2022',95.93 
8197,'01/14/2022',45.89 
8198,'01/15/2022',36.23 
8199,'01/16/2022',25.66 
8200,'01/17/2022',82.77 
8201,'01/18/2022',69.98 
8202,'01/26/2022',76.11 
8203,'01/27/2022',25.12 
8204,'01/28/2022',46.23 
8205,'01/29/2022',84.21 
8206,'01/30/2022',96.24 
8207,'01/31/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :

date

Créez les mesures suivantes :

=inweek (date,'01/14/2022',0), pour calculer si des transactions ont eu lieu au cours de la même semaine que celle du 14 janvier.
=weekday(date), pour indiquer quel jour de la semaine correspond à chaque date.

Tableau de résultats
date	week_day	=inweek (date,'01/14/2022',0)
01/02/2022	Sun	0
01/05/2022	Wed	0
01/06/2022	Thu	0
01/08/2022	Sat	0
01/09/2022	Sun	-1
01/10/2022	Mon	-1
01/11/2022	Tue	-1
01/12/2022	Wed	-1
01/13/2022	Thu	-1
01/14/2022	Fri	-1
01/15/2022	Sat	-1
01/16/2022	Sun	0
01/17/2022	Mon	0
01/18/2022	Tue	0
01/26/2022	Wed	0
01/27/2022	Thu	0
01/28/2022	Fri	0
01/29/2022	Sat	0
01/30/2022	Sun	0
01/31/2022	Mon	0

La mesure ‘in_week’ est créée dans le graphique à l'aide de la fonction inweek(). Le premier argument identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur du 14 janvier, qui est la base_date. L'argument base_date fonctionne avec la variable système FirstWeekDay pour identifier la semaine de comparaison. Le dernier argument est un argument period_no défini sur 0.

Toute transaction qui se produit entre le 9 janvier et le 15 janvier renvoie un résultat booléen TRUE.

Exemple 5 - scénario

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Ensemble de données chargé dans une table appelée ‘Products’.
La table contient les champs suivants :
- product ID
- product type
- manufacture date
- cost price

Il a été identifié que suite, à une erreur d'équipement, des produits fabriqués la semaine du 12 janvier étaient défectueux. L'utilisateur final souhaite un graphique qui affiche, par semaine, l'état des produits fabriqués 'defective' (défectueux) ou 'faultless' (corrects) et le coût des produits fabriqués cette semaine-là.

Script de chargement

Products: 
Load 
* 
Inline  
[ 
product_id,manufacture_date,cost_price
8188,'01/02/2022',37.23 
8189,'01/05/2022',17.17 
8190,'01/06/2022',88.27 
8191,'01/08/2022',57.42 
8192,'01/09/2022',53.80 
8193,'01/10/2022',82.06 
8194,'01/11/2022',40.39 
8195,'01/12/2022',87.21 
8196,'01/13/2022',95.93 
8197,'01/14/2022',45.89 
8198,'01/15/2022',36.23 
8199,'01/16/2022',25.66 
8200,'01/17/2022',82.77 
8201,'01/18/2022',69.98 
8202,'01/26/2022',76.11 
8203,'01/27/2022',25.12 
8204,'01/28/2022',46.23 
8205,'01/29/2022',84.21 
8206,'01/30/2022',96.24 
8207,'01/31/2022',67.67 
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :

=weekname(manufacture_date)

Créez les mesures suivantes :

=if(only(inweek(manufacture_date,makedate(2022,01,12),0)),'Defective','Faultless'), pour identifier les produits défectueux et les produits corrects via la fonction inweek().
=sum(cost_price), pour afficher la somme du coût de chaque produit.

Procédez comme suit :

Définissez le Formatage des nombres des mesures sur Money (Devise).
Sous Aspect, désactivez Totals (Totaux).

Tableau de résultats
weekname(manufacture_date)	=if(only(inweek(manufacture_date,makedate(2022,01,12),0)), 'Defective','Faultless')	Sum(cost_price)
2022/02	Faultless	200.09
2022/03	Defective	441.51
2022/04	Faultless	178.41
2022/05	Faultless	231.67
2022/06	Faultless	163.91

La fonction inweek() renvoie une valeur booléenne lors de l'évaluation des dates de fabrication de chacun des produits. Pour tout produit fabriqué au cours de la semaine du 12 janvier, la fonction inweek() renvoie une valeur booléenne TRUE et identifie les produits comme ‘Defective’ (défectueux). Tout produit renvoyant une valeur FALSE, et par conséquent non fabriqué au cours de cette semaine-là, est identifié comme ‘Faultless’ (correct).

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 !

Laissez vos commentaires ici