Diese Funktion liefert True, wenn timestamp innerhalb der Woche liegt, die base_date enthält.
Syntax:
InWeek (timestamp, base_date, period_no[, first_week_day])
Rückgabe Datentyp: Boolesch
In Qlik Sense wird der boolesche Wert „wahr“ durch -1 dargestellt, der Wert „falsch“ durch 0.
Diagramm des Bereichs der Funktion inweek()
Die Funktion inweek() verwendet das Argument base_date, um zu identifizieren, in welchen Siebentagezeitraum das Datum fällt. Der Starttag der Woche basiert auf der Systemvariablen FirstWeekDay. Sie können aber auch den ersten Tag der Woche ändern, indem Sie das Argument first_week_day in der Funktion inweek() verwenden.
Nachdem die ausgewählte Woche definiert wurde, gibt die Funktion boolesche Ergebnisse zurück, wenn die vordefinierten Datumswerte mit diesem Wochensegment verglichen werden.
Verwendung
Die Funktion InWeek gibt einen booleschen Wert zurück. In der Regel wird dieser Funktionstyp als Bedingung in einer if expression verwendet. Die Funktion InWeek gibt eine Aggregierung oder Berechnung zurück, abhängig davon, ob ein ausgewertetes Datum in die Woche mit dem ausgewählten Datum des Arguments base_date fällt.
Beispielsweise kann die Funktion InWeek verwendet werden, um alle in einer bestimmten Woche gefertigten Geräte zu identifizieren.
| Argument | Beschreibung |
|---|---|
| timestamp | Das Datum, das mit base_date verglichen werden soll. |
| base_date | Datum, das für die Interpretation der Woche verwendet wird. |
| period_no | Mit period_no kann der Beginn der Woche festgelegt werden. period_no ist eine ganze Zahl, wobei 0 für die Woche steht, die base_date enthält. Negative Werte von period_no stehen für vorangehende Wochen, positive Werte für nachfolgende Wochen. |
| first_week_day |
Standardmäßig ist der erste Tag der Woche der Sonntag (wie durch die Systemvariable „FirstWeekDay“ definiert) und beginnt um Mitternacht zwischen Samstag und Sonntag. Der Parameter first_week_day überschreibt die Variable FirstWeekDay. Wenn der Wochenbeginn auf einen anderen Tag fallen soll, geben Sie ein Flag zwischen 0 und 6 an. |
| Tag | Wert |
|---|---|
| Montag | 0 |
| Dienstag | 1 |
| Mittwoch | 2 |
| Donnerstag | 3 |
| Freitag | 4 |
| Samstag | 5 |
| Sonntag | 6 |
Regionaleinstellungen
Sofern nicht anders angegeben, verwenden die Beispiele in diesem Thema das folgende Datumsformat: MM/TT/JJJJ. Das Datumsformat wird in der Anweisung SET DateFormat in Ihrem Datenladeskript angegeben. Das Standarddatumsformat in Ihrem System kann aufgrund Ihrer regionalen Einstellungen und anderer Faktoren abweichen. Sie können die Formate in den Beispielen unten Ihren Anforderungen entsprechend ändern. Sie können auch die Formate in Ihrem Ladeskript entsprechend den Beispielen ändern. Weitere Informationen finden Sie unter Ändern von regionalen Einstellungen für Apps und Skripte.
Regionale Standardeinstellungen in Apps basieren auf dem Benutzerprofil. Diese Einstellungen im regionalen Format hängen nicht mit der Sprache zusammen, die in der Benutzeroberfläche von Qlik Cloud angezeigt wird. Qlik Cloud wird in der gleichen Sprache wie der von Ihnen verwendete Browser angezeigt.
Wenn Sie App-Ersteller sind, können Sie die Standardregion für die von Ihnen erstellte App festlegen. Weitere Informationen finden Sie unter Festlegen der bevorzugten regionalen Einstellungen für die App-und Skripterstellung in Qlik Cloud Analytics.
| Beispiel | Ergebnis |
|---|---|
| inweek ('01/12/2006', '01/14/2006', 0) | Gibt TRUE zurück |
| inweek ('01/12/2006', '01/20/2006', 0 ) | Gibt FALSE zurück |
| inweek ('01/12/2006', '01/14/2006', -1 ) | Gibt FALSE zurück |
| inweek ('01/07/2006', '01/14/2006', -1) | Gibt TRUE zurück |
| inweek ('01/12/2006', '01/09/2006', 0, 3) | Gibt FALSE zurück, weil first_week_day als 3 (Donnerstag) angegeben ist. Dadurch wird 01/12/2006 zum ersten Tag der Woche nach der Woche, die den 01/09/2006 enthält. |
Die folgenden Themen können Sie bei der Arbeit mit dieser Funktion unterstützen:
| Thema | Standardkennzeichen/Wert | Beschreibung |
|---|---|---|
| FirstWeekDay | 6 / Sonntag | Definiert den Starttag jeder Woche. |
Beispiel 1 – keine zusätzlichen Argumente
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
-
Datensatz mit einer Reihe von Transaktionen für den Monat Januar 2022, der in eine Tabelle namens „Transactions“ geladen wird.
-
Die Systemvariable FirstWeekDay ist auf 6 (Sonntag) festgelegt.
-
Ein vorangehender load-Befehl, der Folgendes enthält:
-
Die Funktion inweek(), die als das Feld „in_week“ festgelegt ist, das bestimmt, welche Transaktionen in der Woche vom 14. Januar 2022 stattfanden.
-
Die Funktion weekday(), die als das Feld „week_day“ festgelegt ist, das zeigt, welcher Tag der Woche jedem Datum entspricht.
-
Ladeskript
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
]; Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
week_day
-
in_week
| Datum | week_day | in_week |
|---|---|---|
| 01/02/2022 | So | 0 |
| 01/05/2022 | Mi | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Sa | 0 |
| 01/09/2022 | So | -1 |
| 01/10/2022 | Mo | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Mi | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Fr | -1 |
| 01/15/2022 | Sa | -1 |
| 01/16/2022 | So | 0 |
| 01/17/2022 | Mo | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Mi | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Fr | 0 |
| 01/29/2022 | Sa | 0 |
| 01/30/2022 | So | 0 |
| 01/31/2022 | Mo | 0 |
Das Feld „in_week“ wird in der vorangehenden load-Anweisung mithilfe der Funktion inweek() erstellt. Das erste Argument identifiziert, welches Feld ausgewertet wird. Das zweite Argument ist ein hartcodiertes Datum, der 14. Januar. Dies ist das base_date. Das Argument base_date arbeitet mit der Systemvariablen FirstWeekDay zusammen, um die Vergleichswoche zu identifizieren. Eine period_no von 0 – was bedeutet, dass die Funktion keine Wochen vor oder nach der segmentierten Woche vergleicht – ist das abschließende Argument.
Die Systemvariable FirstWeekDay bestimmt, dass Wochen an einem Sonntag beginnen und an einem Samstag enden. Daher wird der Januar entsprechend dem Diagramm unten in Wochen unterteilt, und die Tage zwischen dem 9. und 15. Januar stellen den gültigen Zeitraum für die Berechnung von inweek() dar:
Diagramm eines Kalenders, in dem der Bereich der Funktion inweek() hervorgehoben ist.
Jede Transaktion, die zwischen dem 9. und 15. Januar stattfindet, gibt ein boolesches Ergebnis von TRUE zurück.
Beispiel 2 – period_no
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
-
Der gleiche Datensatz, der eine Reihe von Transaktionen für 2022 enthält, wird in eine Tabelle namens „Transactions“ geladen.
-
Systemvariable FirstWeekDay, die auf 6 (Sonntag) festgelegt ist
-
Eine vorangehende load-Anweisung, die Folgendes enthält:
-
Die Funktion inweek (), die als das Feld „prev_week“ festgelegt ist, das bestimmt, welche Transaktionen eine ganze Woche vor der Woche des 14. Januar 2022 stattfanden.
-
Die Funktion weekday(), die als das Feld „week_day“ festgelegt ist, das zeigt, welcher Tag der Woche jedem Datum entspricht.
-
Ladeskript
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
]; Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
week_day
-
prev_week
| Datum | week_day | prev_week |
|---|---|---|
| 01/02/2022 | So | -1 |
| 01/05/2022 | Mi | -1 |
| 01/06/2022 | Do | -1 |
| 01/08/2022 | Sa | -1 |
| 01/09/2022 | So | 0 |
| 01/10/2022 | Mo | 0 |
| 01/11/2022 | Di | 0 |
| 01/12/2022 | Mi | 0 |
| 01/13/2022 | Do | 0 |
| 01/14/2022 | Fr | 0 |
| 01/15/2022 | Sa | 0 |
| 01/16/2022 | So | 0 |
| 01/17/2022 | Mo | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Mi | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Fr | 0 |
| 01/29/2022 | Sa | 0 |
| 01/30/2022 | So | 0 |
| 01/31/2022 | Mo | 0 |
Da -1 als Argument period_no in der Funktion inweek() verwendet wird, werden die Grenzen der Vergleichswoche um volle sieben Tage zurück verschoben. Mit einer period_no von 0 liegt die Woche zwischen dem 9. und 15. Januar. In diesem Beispiel verschiebt aber die period_no von -1 die Start- und Endgrenze dieses Segments um eine Woche zurück. Die Datumsgrenzen sind jetzt der 2. bis 8. Januar.
Diagramm eines Kalenders, in dem der Bereich der Funktion inweek() hervorgehoben ist.
Daher gibt jede Transaktion, die zwischen dem 2. und 8. Januar stattfindet, ein boolesches Ergebnis von TRUE zurück.
Beispiel 3 – first_week_day
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
-
Der gleiche Datensatz, der eine Reihe von Transaktionen für 2022 enthält, wird in eine Tabelle namens „Transactions“ geladen.
-
Systemvariable FirstWeekDay, die auf 6 (Sonntag) festgelegt ist
-
Eine vorangehende load-Anweisung, die Folgendes enthält:
-
Die Funktion inweek(), die als das Feld „in_week“ festgelegt ist, das bestimmt, welche Transaktionen in der Woche vom 14. Januar 2022 stattfanden.
-
Die Funktion weekday(), die als das Feld „week_day“ festgelegt ist, das zeigt, welcher Tag der Woche jedem Datum entspricht.
-
Ladeskript
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
]; Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
week_day
-
in_week
| Datum | week_day | in_week |
|---|---|---|
| 01/02/2022 | So | 0 |
| 01/05/2022 | Mi | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Sa | 0 |
| 01/09/2022 | So | 0 |
| 01/10/2022 | Mo | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Mi | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Fr | -1 |
| 01/15/2022 | Sa | -1 |
| 01/16/2022 | So | -1 |
| 01/17/2022 | Mo | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Mi | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Fr | 0 |
| 01/29/2022 | Sa | 0 |
| 01/30/2022 | So | 0 |
| 01/31/2022 | Mo | 0 |
Da 0 als Argument first_week_day in der Funktion inweek() verwendet wird, wird die Systemvariable FirstWeekDay überschrieben und Montag als der erste Tag der Woche festgelegt.
Diagramm eines Kalenders, in dem der Bereich der Funktion inweek() hervorgehoben ist.
Daher gibt jede Transaktion, die zwischen dem 10. und 16. Januar stattfindet, ein boolesches Ergebnis von TRUE zurück.
Beispiel 4 – Diagrammobjektbeispiel
Übersicht
Es werden derselbe Datensatz und dasselbe Szenario wie im ersten Beispiel verwendet.
In diesem Beispiel wird jedoch der unveränderte Datensatz in die Anwendung geladen. Erstellen Sie eine Kennzahl in der Ergebnistabelle, um zu bestimmen, welche Transaktionen in der Woche vom 14. Januar 2022 stattfanden.
Ladeskript
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
]; Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu:
-
date
Erstellen Sie die folgenden Kennzahlen:
-
=inweek (date,'01/14/2022',0), um zu berechnen, ob Transaktionen in der Woche vom 14. Januar stattfanden.
-
=weekday(date), um zu zeigen, welcher Tag der Woche jeweils dem Datum entspricht.
| Datum | week_day | =inweek (date,'01/14/2022',0) |
|---|---|---|
| 01/02/2022 | So | 0 |
| 01/05/2022 | Mi | 0 |
| 01/06/2022 | Do | 0 |
| 01/08/2022 | Sa | 0 |
| 01/09/2022 | So | -1 |
| 01/10/2022 | Mo | -1 |
| 01/11/2022 | Di | -1 |
| 01/12/2022 | Mi | -1 |
| 01/13/2022 | Do | -1 |
| 01/14/2022 | Fr | -1 |
| 01/15/2022 | Sa | -1 |
| 01/16/2022 | So | 0 |
| 01/17/2022 | Mo | 0 |
| 01/18/2022 | Di | 0 |
| 01/26/2022 | Mi | 0 |
| 01/27/2022 | Do | 0 |
| 01/28/2022 | Fr | 0 |
| 01/29/2022 | Sa | 0 |
| 01/30/2022 | So | 0 |
| 01/31/2022 | Mo | 0 |
Die Kennzahl „in_week“ wird im Diagramm anhand der Funktion inweek() erstellt. Das erste Argument identifiziert, welches Feld ausgewertet wird. Das zweite Argument ist ein hartcodiertes Datum, der 14. Januar. Dies ist das base_date. Das Argument base_date arbeitet mit der Systemvariablen FirstWeekDay zusammen, um die Vergleichswoche zu identifizieren. Eine period_no von 0 ist das abschließende Argument.
Die Systemvariable FirstWeekDay bestimmt, dass Wochen an einem Sonntag beginnen und an einem Samstag enden. Daher wird der Januar entsprechend dem Diagramm unten in Wochen unterteilt, und die Tage zwischen dem 9. und 15. Januar stellen den gültigen Zeitraum für die Berechnung von inweek() dar:
Diagramm eines Kalenders, in dem der Bereich der Funktion inweek() hervorgehoben ist.
Jede Transaktion, die zwischen dem 9. und 15. Januar stattfindet, gibt ein boolesches Ergebnis von TRUE zurück.