Deze functie retourneert True als timestamp binnen de week valt die base_date bevat.
Syntaxis:
InWeek (timestamp, base_date, period_no[, first_week_day])
Retourgegevenstypen: Booleaanse waarde
In Qlik Sense wordt de booleaanse waarde Waar vertegenwoordigd door -1 en de waarde Onwaar door 0.
Diagram van het bereik van de inweek()-functie
De inweek()-functie gebruikt het argument base_date om te identificeren in welke zevendaagse periode dag valt. De begindag van de week wordt gebaseerd op de systeemvariabele FirstWeekDay. U kunt echter ook de eerste dag van de week wijzigen door het first_week_day-argument in de inweek()-functie te gebruiken.
Nadat de geselecteerde week is gedefinieerd, retourneert de functie booleaanse resultaten bij het vergelijken van de voorgeschreven datumwaarden met dat weeksegment.
Wanneer gebruiken
De functie inweek() retourneert een booleaanse waarde. Dit type functie wordt doorgaans gebruikt als voorwaarde in een if expression. De inweek()-functie retourneert een aggregatie of berekening die afhankelijk is van of een geëvalueerde datum in de week valt met de geselecteerde datum van het base_date-argument.
De inweek()-functie kan bijvoorbeeld worden gebruikt om alle materieel te identificeren dat in een specifieke week is geproduceerd.
| Argument | Beschrijving |
|---|---|
| timestamp | De datum die u wilt vergelijken met base_date. |
| base_date | Datum op basis waarvan de week wordt geëvalueerd. |
| period_no | De week kan worden verschoven met period_no. period_no is een geheel getal, waarbij de waarde 0 de week aangeeft die base_date bevat. Negatieve waarden in period_no geven voorgaande weken aan en positieve waarden geven volgende weken aan. |
| first_week_day |
Standaard is de eerste dag van de week zondag (zoals bepaald door de systeemvariabele FirstWeekDay), beginnend om middernacht tussen zaterdag en zondag. De parameter first_week_day vervangt de variabele FirstWeekDay. Geef aan dat de week op een andere dag begint door een vlag tussen 0 en 6 op te geven. |
| Dag | Waarde |
|---|---|
| Maandag | 0 |
| Dinsdag | 1 |
| Woensdag | 2 |
| Donderdag | 3 |
| Vrijdag | 4 |
| Zaterdag | 5 |
| Zondag | 6 |
Landinstellingen
Tenzij anders aangegeven, wordt in de voorbeelden in dit onderwerp de volgende datumindeling gebruikt: MM/DD/JJJJ. De datumopmaak wordt opgegeven in de opdracht SET DateFormat in uw script voor het laden van gegevens. De standaard datumindeling is mogelijk anders op uw systeem vanwege landinstellingen en andere factoren. U kunt de indelingen in de voorbeelden wijzigen zodat deze aansluiten op uw behoeften. Of u kunt de indelingen in uw load-script wijzigen zodat ze overeenkomen met deze voorbeelden. Ga voor meer informatie naar Regionale instellingen voor apps en scripts aanpassen.
Standaard landinstellingen van de app zijn gebaseerd op het gebruikersprofiel. Deze landinstellingen voor indelingen zijn niet gerelateerd aan de taal die wordt weergegeven in de gebruikersinterface van Qlik Cloud. Qlik Cloud wordt weergegeven in dezelfde taal als de browser die u gebruikt.
Als u een app-ontwikkelaar bent, kunt u de standaardregio instellen voor apps die u maakt. Ga voor meer informatie naar Instellen van uw voorkeur voor regionale instellingen voor het maken van apps en scripts in Qlik Cloud Analyse.
| Voorbeeld | Resultaat |
|---|---|
| inweek ('01/12/2006', '01/14/2006', 0) | Retourneert TRUE |
| inweek ('01/12/2006', '01/20/2006', 0 ) | Retourneert FALSE |
| inweek ('01/12/2006', '01/14/2006', -1 ) | Retourneert FALSE |
| inweek ('01/07/2006', '01/14/2006', -1) | Retourneert TRUE |
| inweek ('01/12/2006', '01/09/2006', 0, 3) | Retourneert FALSE omdat first_week_day is gespecificeerd als 3 (donderdag), waardoor 01/12/2006 de eerste dag van de week is na de week waarin 01/09/2006 valt. |
Deze onderwerpen kunnen u helpen bij het werken met deze functie:
| Onderwerp | Standaardvlag/-waarde | Beschrijving |
|---|---|---|
| FirstWeekDay | 6 / zondag | Definieert de begindag van elke week. |
Voorbeeld 1 – Geen aanvullende argumenten
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
-
Een gegevensverzameling met een set transacties voor de maand januari 2022 die wordt geladen in de tabel Transactions.
-
De systeemvariabele FirstWeekDay die is ingesteld op 6 (zondag).
-
Een voorgaande lading die het volgende bevat:
-
De inweek()-functie die is ingesteld als het in_week-veld dat bepaalt welke transacties hebben plaatsgevonden in de week tot en met 14 januari 2022.
-
De weekday()-functie, ingesteld als het veld week_day, toont welke dag van de week overeenkomt met iedere datum.
-
Load-script
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
]; Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:
-
date
-
week_day
-
in_week
| date | week_day | in_week |
|---|---|---|
| 01/02/2022 | Zo | 0 |
| 01/05/2022 | Wo | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Za | 0 |
| 01/09/2022 | Zo | -1 |
| 01/10/2022 | Ma | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Wo | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Vr | -1 |
| 01/15/2022 | Za | -1 |
| 01/16/2022 | Zo | 0 |
| 01/17/2022 | Ma | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Wo | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Vr | 0 |
| 01/29/2022 | Za | 0 |
| 01/30/2022 | Zo | 0 |
| 01/31/2022 | Ma | 0 |
Het veld in_week wordt gemaakt in de vorige load-instructie met behulp van de functie inweek(). Het eerste argument identificeert welk veld wordt geëvalueerd. Het tweede argument is een vastgestelde datum, 14 januari, wat de base_date is. Het base_date-argument werkt met de FirstWeekDay-systeemvariabele om de week te bepalen waarmee moet worden vergeleken. Een period_no van 0 is het laatste argument, wat betekent dat de functie geen kwartalen voor of na het gesegmenteerde kwartaal vergelijkt.
De systeemvariabele FirstWeekDay bepaalt dat weken beginnen op een zondag en eindigen op een zaterdag. Daarom zou januari worden opgedeeld in weken volgens het onderstaande diagram, waarbij de datums tussen 9 en 15 januari de geldige periode vormen voor de inweek() berekening:
Diagram van kalender met het bereik van de inweek()-functie gemarkeerd
Elke transactie die tussen 9 januari en 15 januari plaatsvindt, retourneert een booleaans resultaat voor TRUE.
Voorbeeld 2 – period_no
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
-
Dezelfde gegevensset met een set transacties voor 2022 wordt in de tabel Transactions geladen.
-
De systeemvariabele FirstWeekDay die is ingesteld op 6 (zondag).
-
Een voorgaande lading die het volgende bevat:
-
De inweek ()-functie die is ingesteld als het prev_week-veld dat bepaalt welke transacties hebben plaatsgevonden in de week voorafgaand aan de week waarin 14 januari 2022 valt.
-
De weekday()-functie, ingesteld als het veld week_day, toont welke dag van de week overeenkomt met iedere datum.
-
Load-script
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
]; Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:
-
date
-
week_day
-
prev_week
| date | week_day | prev_week |
|---|---|---|
| 01/02/2022 | Zo | -1 |
| 01/05/2022 | Wo | -1 |
| 01/06/2022 | Do | -1 |
| 01/08/2022 | Za | -1 |
| 01/09/2022 | Zo | 0 |
| 01/10/2022 | Ma | 0 |
| 01/11/2022 | Di | 0 |
| 01/12/2022 | Wo | 0 |
| 01/13/2022 | Do | 0 |
| 01/14/2022 | Vr | 0 |
| 01/15/2022 | Za | 0 |
| 01/16/2022 | Zo | 0 |
| 01/17/2022 | Ma | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Wo | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Vr | 0 |
| 01/29/2022 | Za | 0 |
| 01/30/2022 | Zo | 0 |
| 01/31/2022 | Ma | 0 |
Door -1 als het period_no-argument in de inweek()-functie te gebruiken, verschuift de functie de grenzen van de vergelijkingsweek terug met zeven dagen. Met een period_no van 0, zou de week tussen 9 en 15 januari vallen. Maar in dit voorbeeld verschuift de period_no van -1 de begin- en eindgrens van dit segment terug met één week. De datumgrenzen worden 2 t/m 8 januari.
Diagram van kalender met het bereik van de inweek()-functie gemarkeerd
Daarom zal elke transactie die plaatsvindt tussen 2 januari en 8 januari een booleaans resultaat voor TRUE retourneren.
Voorbeeld 3 – first_week_day
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
-
Dezelfde gegevensset met een set transacties voor 2022 wordt in de tabel Transactions geladen.
-
De systeemvariabele FirstWeekDay die is ingesteld op 6 (zondag).
-
Een voorgaande lading die het volgende bevat:
-
De inweek()-functie die is ingesteld als het in_week-veld dat bepaalt welke transacties hebben plaatsgevonden in de week tot en met 14 januari 2022.
-
De weekday()-functie, ingesteld als het veld week_day, toont welke dag van de week overeenkomt met iedere datum.
-
Load-script
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
]; Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:
-
date
-
week_day
-
in_week
| date | week_day | in_week |
|---|---|---|
| 01/02/2022 | Zo | 0 |
| 01/05/2022 | Wo | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Za | 0 |
| 01/09/2022 | Zo | 0 |
| 01/10/2022 | Ma | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Wo | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Vr | -1 |
| 01/15/2022 | Za | -1 |
| 01/16/2022 | Zo | -1 |
| 01/17/2022 | Ma | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Wo | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Vr | 0 |
| 01/29/2022 | Za | 0 |
| 01/30/2022 | Zo | 0 |
| 01/31/2022 | Ma | 0 |
Door 0 te gebruiken als het first_week_day-argument in de inweek()-functie, wordt de FirstWeekDay-systeemvariabele vervangen en maandag ingesteld als de eerste dag van de week.
Diagram van kalender met het bereik van de inweek()-functie gemarkeerd
Daarom zal elke transactie die plaatsvindt tussen 10 en 16 januari een booleaans resultaat voor TRUE retourneren.
Voorbeeld 4 – Diagramobjectvoorbeeld
Overzicht
Dezelfde gegevensverzameling en het scenario uit het eerste voorbeeld worden gebruikt.
In dit voorbeeld is de gegevensverzameling echter niet gewijzigd en wordt in de applicatie geladen. Maak een meting in de resultatentabel om te bepalen welke transacties plaatsvonden in de week van 14 januari 2022.
Load-script
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
]; Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie:
-
date
Maak de volgende metingen:
-
=inweek (date,'01/14/2022',0) om te bepalen of transacties in de week van 14 januari plaatsvonden.
-
=weekday(date) om aan te geven welke dag van de week overeenkomt met elke datum.
| date | week_day | =inweek (date,'01/14/2022',0) |
|---|---|---|
| 01/02/2022 | Zo | 0 |
| 01/05/2022 | Wo | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Za | 0 |
| 01/09/2022 | Zo | -1 |
| 01/10/2022 | Ma | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Wo | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Vr | -1 |
| 01/15/2022 | Za | -1 |
| 01/16/2022 | Zo | 0 |
| 01/17/2022 | Ma | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Wo | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Vr | 0 |
| 01/29/2022 | Za | 0 |
| 01/30/2022 | Zo | 0 |
| 01/31/2022 | Ma | 0 |
De meting in_week wordt in het diagram gemaakt met behulp van de inweek()-functie. Het eerste argument identificeert welk veld wordt geëvalueerd. Het tweede argument is een vastgestelde datum, 14 januari, wat de base_date is. Het base_date-argument werkt met de FirstWeekDay-systeemvariabele om de week te bepalen waarmee moet worden vergeleken. Een period_no van 0 is het laatste argument.
De systeemvariabele FirstWeekDay bepaalt dat weken beginnen op een zondag en eindigen op een zaterdag. Daarom zou januari worden opgedeeld in weken volgens het onderstaande diagram, waarbij de datums tussen 9 en 15 januari de geldige periode vormen voor de inweek() berekening:
Diagram van kalender met het bereik van de inweek()-functie gemarkeerd
Elke transactie die tussen 9 januari en 15 januari plaatsvindt, retourneert een booleaans resultaat voor TRUE.