inweek - Skript- und Diagrammfunktion

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.

Das Diagramm zeigt, wie die Funktion „inweek()“ verwendet werden kann, um Datumswerte innerhalb von Wochensegmenten auszuwerten und ein boolesches Ergebnis zurückzugeben, wenn ein Datum in einen ausgewählten Bereich fällt bzw. nicht fällt. — 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.

Argumente
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.

Werte für first_week_day
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.

Funktionsbeispiele
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:

Verwandte Themen
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

Ergebnistabelle
date	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, das einen Monat zeigt, in dem die Datumswerte vom 9. bis zum 15. grün hervorgehoben sind. Der 9. ist ein Sonntag und der 15. ein Samstag. — 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

Ergebnistabelle
date	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, das einen Monat zeigt, in dem die Datumswerte vom 2. bis zum 8. grün hervorgehoben sind. Der 2. ist ein Sonntag und der 8. ein Samstag. — 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

Ergebnistabelle
date	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, das einen Monat zeigt, in dem die Datumswerte vom 10. bis zum 16. grün hervorgehoben sind. Der 10. ist ein Montag und der 16. ein Sonntag. — 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.

Ergebnistabelle
date	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.

Jede Transaktion, die zwischen dem 9. und 15. Januar stattfindet, gibt ein boolesches Ergebnis von TRUE zurück.

Beispiel 5 – Szenario

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript umfasst:

Datensatz, der in eine Tabelle namens „Products“ geladen wird
Die Tabelle enthält die folgenden Felder:
- product ID
- product type
- manufacture date
- cost price

Es wurde festgestellt, dass aufgrund eines Gerätefehlers die in der Woche vom 12. Januar hergestellten Produkte mangelhaft waren. Der Endbenutzer möchte ein Diagramm, das nach Woche den Status der hergestellten Produkte angibt und zeigt, welche „mangelhaft“ und welche „einwandfrei“ waren und was die in dieser Woche gefertigten Produkte gekostet haben.

Ladeskript

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 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu:

=weekname(manufacture_date)

Erstellen Sie die folgenden Kennzahlen:

=if(only(inweek(manufacture_date,makedate(2022,01,12),0)),'Defective','Faultless'), um zu identifizieren, welche Produkte mangelhaft und welche einwandfrei sind. Verwenden Sie dafür die Funktion inweek().
=sum(cost_price), um die Summe der Kosten für jedes Produkt zu zeigen.

Gehen Sie folgendermaßen vor:

Legen Sie das Zahlenformat der Kennzahl auf Währung fest.
Deaktivieren Sie unter Darstellung die Option Gesamtwerte.

Ergebnistabelle
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

Die Funktion inweek() gibt einen booleschen Wert zurück, wenn sie das Herstellungsdatum der einzelnen Produkte auswertet. Für alle in der Woche vom 12. Januar hergestellten Produkte gibt die Funktion inweek() einen booleschen Wert von TRUE zurück und markiert die Produkte als „mangelhaft“. Alle Produkte, die einen Wert von FALSE zurückgeben und daher nicht in der betreffenden Woche gefertigt wurden, werden als „einwandfrei“ markiert.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab