Questa funzione restituisce True se timestamp ricade all'interno della settimana contenente base_date.
Sintassi:
InWeek (timestamp, base_date, period_no[, first_week_day])
Tipo di dati restituiti: Booleano
In Qlik Sense, il valore booleano vero è rappresentato da -1 e il valore falso è rappresentato da 0.
Schema dell'intervallo della funzione inweek()
La funzione inweek() utilizza l'argomento base_date per identificare in quale periodo di sette giorni cade la data. Il giorno iniziale della settimana si basa sulla variabile di sistema FirstWeekDay. Tuttavia, è possibile anche modificare il primo giorno della settimana utilizzando l'argomento first_week_day nella funzione inweek().
Dopo aver definito la settimana selezionata, la funzione restituisce risultati booleani quando si confrontano i valori delle date prescritte con quel segmento di settimana.
Casi di utilizzo
La funzione inweek() restituisce un risultato booleano. In genere, questo tipo di funzione viene utilizzato come condizione in un file if expression. La funzione inweek() restituisce un'aggregazione o un calcolo che dipende dal fatto che una data valutata si sia verificata nella settimana con la data selezionata dell'argomento base_date.
Ad esempio, la funzione inweek() può essere utilizzata per identificare tutte le apparecchiature prodotte in una determinata settimana.
| Argomento | Descrizione |
|---|---|
| timestamp | La data da confrontare con base_date. |
| base_date | La data utilizzata per valutare la settimana. |
| period_no | La settimana può essere differita mediante period_no. period_no è un numero intero, in cui il valore 0 indica la settimana che contiene base_date. I valori negativi di period_no indicano le settimane precedenti, mentre i valori positivi indicano le settimane successive. |
| first_week_day |
Per impostazione predefinita, il primo giorno della settimana è domenica (come determinato dalla variabile di sistema FirstWeekDay), a partire dalla mezzanotte tra sabato e domenica. Il parametro first_week_day sostituisce la variabile FirstWeekDay. Per indicare un altro giorno per l'inizio della settimana, specificare un contrassegno con valore da 0 a 6. |
| Giorno | Valore |
|---|---|
| Lunedì | 0 |
| Martedì | 1 |
| Mercoledì | 2 |
| Giovedì | 3 |
| Venerdì | 4 |
| Sabato | 5 |
| Domenica | 6 |
Impostazioni locali
Se non diversamente specificato, gli esempi di questo argomento utilizzano il seguente formato di data: MM/GG/AAAA. Il formato della data viene specificato nell'istruzione SET DateFormat nello script di caricamento dei dati. La formattazione predefinita della data potrebbe essere diversa nel proprio sistema, a causa delle impostazioni regionali e di altri fattori. È possibile modificare i formati degli esempi seguenti in base alle proprie esigenze. In alternativa, è possibile modificare i formati nel proprio script di caricamento per adattarli a questi esempi. Per ulteriori informazioni, vedere Modifica delle impostazioni internazionali per la creazione di app e script.
Le impostazioni regionali predefinite nelle app si basano sul profilo utente. Queste impostazioni di formato regionale non riguardano la lingua visualizzata nell'interfaccia utente Qlik Cloud. Qlik Cloud verrà visualizzato nella stessa lingua del browser utilizzato.
Se si è un creatore di app, è possibile impostare la regione predefinita per le app che si creano. Per ulteriori informazioni, vedere Regolazione delle impostazioni internazionali preferite per la creazione di app e script in Qlik Cloud Analytics.
| Esempio | Risultato |
|---|---|
| inweek ('01/12/2006', '01/14/2006', 0) | Restituisce TRUE |
| inweek ('01/12/2006', '01/20/2006', 0 ) | Restituisce FALSE |
| inweek ('01/12/2006', '01/14/2006', -1 ) | Restituisce FALSE |
| inweek ('01/07/2006', '01/14/2006', -1) | Restituisce TRUE |
| inweek ('01/12/2006', '01/09/2006', 0, 3) | Restituisce FALSE perché first_week_day è specificato come 3 (giovedì), il che rende il 12/01/2006 il primo giorno della settimana successiva a quella contenente il giorno 09/01/2006. |
I seguenti argomenti possono aiutarti a lavorare con questa funzione:
| Argomento | Contrassegno predefinito / Valore | Descrizione |
|---|---|---|
| FirstWeekDay | 6 / Sunday | Definisce il giorno di inizio di ogni settimana. |
Esempio 1 - Nessun argomento aggiuntivo
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Un set di dati contenente un insieme di transazioni per il mese di gennaio 2022, caricato in una tabella denominata 'Transactions'.
-
La variabile di sistema FirstWeekDay che è impostata su 6 (domenica).
-
Un'istruzione di caricamento precedente che contiene i seguenti elementi:
-
La funzione inweek(), impostata come campo 'in_week' che determina quali transazioni hanno avuto luogo nella settimana del 14 gennaio 2022.
-
La funzione weekday(), impostata come campo 'week_day' che mostra quale giorno della settimana corrisponde a ciascuna data.
-
Script di caricamento
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
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
date
-
week_day
-
in_week
| data | 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 |
Il campo 'in_week' viene creato nell'istruzione di caricamento precedente utilizzando la funzione inweek(). Il primo argomento identifica il campo da valutare. Il secondo argomento è una data codificata, il 14 gennaio, che è il base_date. L'argomento base_date collabora con la variabile di sistema FirstWeekDay per identificare la settimana del comparatore. Un period_no di 0 — significa che la funzione non sta confrontando le settimane precedenti o successive alla settimana segmentata – è l'argomento finale.
La variabile di sistema determina che le settimane iniziano di domenica e terminano di sabato.FirstWeekDay Pertanto, gennaio viene suddiviso in settimane secondo lo schema seguente, con le date comprese tra il 9 e il 15 gennaio che forniscono il periodo valido per il calcolo inweek():
Schema del calendario con evidenziato l'intervallo della funzione inweek()
Qualsiasi transazione avvenuta tra il 9 e il 15 gennaio restituisce il risultato booleano di TRUE.
Esempio 2 - period_no
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Lo stesso set di dati contenente un insieme di transazioni per il 2022 viene caricato in una tabella denominata 'Transactions'.
-
La variabile di sistema FirstWeekDay che è impostata su 6 (domenica).
-
Un'istruzione di caricamento precedente che contiene i seguenti elementi:
-
La funzione inweek (), impostata come campo 'prev_week' che determina quali transazioni hanno avuto luogo in un'intera settimana prima della settimana del 14 gennaio 2022.
-
La funzione weekday(), impostata come campo 'week_day' che mostra quale giorno della settimana corrisponde a ciascuna data.
-
Script di caricamento
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
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
date
-
week_day
-
prev_week
| data | 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 |
L'utilizzo di -1 come argomento period_no nella funzione inweek() sposta i confini della settimana del comparatore indietro di sette giorni interi. Con un period_no di 0 la settimana sarebbe compresa tra il 9 e il 15 gennaio. Eppure in questo esempio, il period_no di -1 sposta il confine iniziale e finale di questo segmento indietro di una settimana. I limiti di data diventano dal 2 gennaio all'8 gennaio.
Schema del calendario con evidenziato l'intervallo della funzione inweek()
Pertanto, qualsiasi transazione che si verifichi tra il 2 gennaio e l'8 gennaio restituirà il risultato booleano di TRUE.
Esempio 3 - first_week_day
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Lo stesso set di dati contenente un insieme di transazioni per il 2022 viene caricato in una tabella denominata 'Transactions'.
-
La variabile di sistema FirstWeekDay che è impostata su 6 (domenica).
-
Un'istruzione di caricamento precedente che contiene i seguenti elementi:
-
La funzione inweek(), impostata come campo 'in_week' che determina quali transazioni hanno avuto luogo nella settimana del 14 gennaio 2022.
-
La funzione weekday(), impostata come campo 'week_day' che mostra quale giorno della settimana corrisponde a ciascuna data.
-
Script di caricamento
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
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
date
-
week_day
-
in_week
| data | 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 |
Utilizzando 0 come argomento first_week_day nella funzione inweek() si sostituisce la variabile di sistema FirstWeekDay e si imposta lunedì come primo giorno della settimana.
Schema del calendario con evidenziato l'intervallo della funzione inweek()
Pertanto, qualsiasi transazione che si verifichi tra il 10 e il 16 gennaio restituirà un risultato booleano di TRUE.
Esempio 4 - Esempio di oggetto grafico
Panoramica
Vengono utilizzati lo stesso set di dati e lo stesso scenario del primo esempio.
Tuttavia, in questo esempio, il set di dati è invariato e viene caricato nell'applicazione. Creare una misura nella tabella dei risultati per determinare quali transazioni sono state effettuate nella settimana del 14 gennaio 2022.
Script di caricamento
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
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione:
-
date
Creare le seguenti misure:
-
=inweek (date,'01/14/2022',0), per calcolare se le transazioni sono avvenute nella stessa settimana del 14 gennaio.
-
=weekday(date), per mostrare quale giorno della settimana corrisponde a ciascuna data.
| data | 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 misura 'in_week' viene creata nel grafico utilizzando la funzione inweek(). Il primo argomento identifica il campo da valutare. Il secondo argomento è una data codificata, il 14 gennaio, che è il base_date. L'argomento base_date collabora con la variabile di sistema FirstWeekDay per identificare la settimana del comparatore. Un period_no di 0 rappresenta l'argomento finale.
La variabile di sistema determina che le settimane iniziano di domenica e terminano di sabato.FirstWeekDay Pertanto, gennaio viene suddiviso in settimane secondo lo schema seguente, con le date comprese tra il 9 e il 15 gennaio che forniscono il periodo valido per il calcolo inweek():
Schema del calendario con evidenziato l'intervallo della funzione inweek()
Qualsiasi transazione avvenuta tra il 9 e il 15 gennaio restituisce il risultato booleano di TRUE.