Questa funzione restituisce l'anno a cui appartiene il numero della settimana in base alle variabili di ambiente. I numeri della settimana rientrano in un intervallo approssimativo compreso tra 1 e 52.
Sintassi:
weekyear(timestamp [, first_week_day [, broken_weeks [, reference_day]]])
Tipo di dati restituiti: numero intero
| Argomento | Descrizione |
|---|---|
| timestamp | La data o la data e ora da valutare. |
| first_week_day |
Specifica il giorno di inizio della settimana. Se omesso, viene utilizzato il valore della variabile FirstWeekDay. I valori possibili per first_week_day sono 0 per lunedì, 1 per martedì, 2 per mercoledì, 3 per giovedì, 4 per venerdì, 5 per sabato e 6 per domenica. Per maggiori informazioni sulle variabili di sistema, vedere FirstWeekDay. |
| broken_weeks |
Se non si specificabroken_weeks, il valore della variabile BrokenWeeks verrà utilizzato per definire se le settimane sono interrotte o meno. Per maggiori informazioni sulle variabili di sistema, vedere BrokenWeeks. |
| reference_day |
Se non si specificareference_day, il valore della variabile ReferenceDay verrà utilizzato per definire quale giorno di gennaio impostare come giorno di riferimento per definire la settimana 1. Per impostazione predefinita, le funzioni Qlik Sense utilizzano 4 come giorno di riferimento. Questo significa che la settimana 1 deve contenere il 4 gennaio, vale a dire che la settimana 1 deve sempre contenere 4 quattro giorni di gennaio. Per maggiori informazioni sulle variabili di sistema, vedere ReferenceDay. |
La funzione weekyear() determina in quale settimana dell'anno cade una data. Quindi restituisce l'anno corrispondente a quel numero di settimana.
Se BrokenWeeks è impostato su 0 (false), weekyear() restituirà lo stesso come year().
Schema dell'intervallo della funzione weekyear()
Tuttavia, se la variabile di sistema BrokenWeeks è impostata per l'utilizzo di settimane intere, la settimana 1 deve contenere solo un certo numero di giorni di gennaio, in base al valore specificato nella variabile di sistema ReferenceDay.
Ad esempio, se si utilizza un valore ReferenceDay pari a 4, la settimana 1 deve includere almeno quattro giorni di gennaio. È possibile che la settimana 1 includa date del dicembre dell'anno precedente o che il numero della settimana finale di un anno includa date del gennaio dell'anno successivo. In situazioni come questa, la funzione weekyear() restituirà un valore diverso per la funzione year().
Schema dell'intervallo della funzione weekyear() quando si utilizzano le settimane intere
Casi di utilizzo
La funzione weekyear() è utile quando si desidera confrontare le aggregazioni per anni. Ad esempio, può essere usata se si desidera visualizzare le vendite totali dei prodotti in base all'anno. La funzione weekyear() viene scelta rispetto a year() quando l'utente desidera mantenere la coerenza con la variabile di sistema BrokenWeeks nell'app.
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 |
|---|---|
| weekyear('12/30/1996',0,0,4) | Restituisce 1997, poiché la settimana 1 del 1997 inizia il 30/12/1996 |
| weekyear('01/02/1997',0,0,4) | Restituisce 1997 |
| weekyear('12/28/1997',0,0,4) | Restituisce 1997 |
| weekyear('12/30/1997',0,0,4) | Restituisce il 1998, perché la settimana 1 del 1998 inizia il 29/12/1997 |
| weekyear('01/02/1999',0,0,4) | Restituisce il 1998, perché la settimana 53 del 1998 termina il 03/01/1999 |
| Argomento | Interazione |
|---|---|
| week - funzione dello script e del grafico | Restituisce un numero intero che rappresenta il numero della settimana in base allo standard ISO 8601 |
| year - funzione dello script e del grafico | Restituisce un numero intero che rappresenta l'anno in cui l'espressione viene interpretata come data in base all'interpretazione numerica standard. |
Esempio 1 - Settimane parziali
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 l'ultima settimana del 2020 e la prima settimana del 2021 che viene caricato in una tabella chiamata 'Transactions'.
-
La variabile di sistema BrokenWeeks che è impostata su 1.
-
Un'istruzione di caricamento precedente che contiene i seguenti elementi:
-
La funzione weekyear(), impostata come campo 'week_year', che restituisce l'anno in cui sono avvenute le transazioni.
-
La funzione week(), impostata come campo 'week', che mostra il numero di settimana di ogni data di transazione.
-
Script di caricamento
SET BrokenWeeks=1;
Transactions:
Load
*,
week(date) as week,
weekyear(date) as week_year
;
Load
*
Inline
[
id,date,amount
8176,12/28/2020,19.42
8177,12/29/2020,23.80
8178,12/30/2020,82.06
8179,12/31/2020,40.56
8180,01/01/2021,37.23
8181,01/02/2021,17.17
8182,01/03/2021,88.27
8183,01/04/2021,57.42
8184,01/05/2021,67.42
8185,01/06/2021,23.80
8186,01/07/2021,82.06
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
id
-
date
-
week
-
week_year
| id | date | settimana | week_year |
|---|---|---|---|
| 8176 | 12/28/2020 | 53 | 2020 |
| 8177 | 12/29/2020 | 53 | 2020 |
| 8178 | 12/30/2020 | 53 | 2020 |
| 8179 | 12/31/2020 | 53 | 2020 |
| 8180 | 01/01/2021 | 1 | 2021 |
| 8181 | 01/02/2021 | 1 | 2021 |
| 8182 | 01/03/2021 | 2 | 2021 |
| 8183 | 01/04/2021 | 2 | 2021 |
| 8184 | 01/05/2021 | 2 | 2021 |
| 8185 | 01/06/2021 | 2 | 2021 |
| 8186 | 01/07/2021 | 2 | 2021 |
Il campo 'week_year' viene creato nell'istruzione di caricamento precedente mediante l'uso della funzione weekyear() e trasferendo il campo data come argomento della funzione.
La variabile di sistema BrokenWeeks è impostata su 1, il che significa che l'app utilizza settimane parziali. La settimana 1 inizia il 1° gennaio.
Schema dell'intervallo della funzione weekyear() con l'uso di settimane parziali
La transazione 8181 ha luogo il 2 gennaio, che fa parte della settimana 1. Pertanto, restituisce un valore di 2021 per il campo 'week_year'.
Esempio 2 - Settimane intere
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 l'ultima settimana del 2020 e la prima settimana del 2021 che viene caricato in una tabella chiamata 'Transactions'.
-
La variabile di sistema BrokenWeeks che è impostata su 0.
-
Un'istruzione di caricamento precedente che contiene i seguenti elementi:
-
La funzione weekyear(), impostata come campo 'week_year', che restituisce l'anno in cui sono avvenute le transazioni.
-
La funzione week(), impostata come campo 'week', che mostra il numero di settimana di ogni data di transazione.
-
Tuttavia, in questo esempio, la politica aziendale prevede l'utilizzo di settimane intere.
Script di caricamento
SET BrokenWeeks=0;
Transactions:
Load
*,
week(date) as week,
weekyear(date) as week_year
;
Load
*
Inline
[
id,date,amount
8176,12/28/2020,19.42
8177,12/29/2020,23.80
8178,12/30/2020,82.06
8179,12/31/2020,40.56
8180,01/01/2021,37.23
8181,01/02/2021,17.17
8182,01/03/2021,88.27
8183,01/04/2021,57.42
8184,01/05/2021,67.42
8185,01/06/2021,23.80
8186,01/07/2021,82.06
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
id
-
date
-
week
-
week_year
| id | date | settimana | week_year |
|---|---|---|---|
| 8176 | 12/28/2020 | 53 | 2020 |
| 8177 | 12/29/2020 | 53 | 2020 |
| 8178 | 12/30/2020 | 53 | 2020 |
| 8179 | 12/31/2020 | 53 | 2020 |
| 8180 | 01/01/2021 | 53 | 2020 |
| 8181 | 01/02/2021 | 53 | 2020 |
| 8182 | 01/03/2021 | 1 | 2021 |
| 8183 | 01/04/2021 | 1 | 2021 |
| 8184 | 01/05/2021 | 1 | 2021 |
| 8185 | 01/06/2021 | 1 | 2021 |
| 8186 | 01/07/2021 | 1 | 2021 |
La variabile di sistema BrokenWeeks è impostata su 0, il che significa che l'applicazione utilizza settimane intere. Pertanto, non è necessario che la settimana 1 inizi il 1° gennaio.
La settimana 53 del 2020 continua fino alla fine del 2 gennaio 2021, mentre la settimana 1 del 2020 inizia domenica 3 gennaio 2021.
Schema dell'intervallo della funzione weekyear() con l'uso di settimane intere
La transazione 8181 ha luogo il 2 gennaio, che fa parte della settimana 1. Pertanto, restituisce un valore di 2021 per il campo 'week_year'.
Esempio 3 - 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. Il calcolo che restituisce il numero della settimana dell'anno in cui sono avvenute le transazioni viene creato come misura in un grafico dell'app.
Script di caricamento
SET BrokenWeeks=1;
Transactions:
Load
*
Inline
[
id,date,amount
8176,12/28/2020,19.42
8177,12/29/2020,23.80
8178,12/30/2020,82.06
8179,12/31/2020,40.56
8180,01/01/2021,37.23
8181,01/02/2021,17.17
8182,01/03/2021,88.27
8183,01/04/2021,57.42
8184,01/05/2021,67.42
8185,01/06/2021,23.80
8186,01/07/2021,82.06
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
id
-
date
Per calcolare la settimana in cui avviene una transazione, creare la seguente misura:
-
=week(date)
Per calcolare l'anno in cui avviene una transazione in base al numero della settimana, creare la seguente misura:
-
=weekyear(date)
| id | date | settimana | week_year |
|---|---|---|---|
| 8176 | 12/28/2020 | 53 | 2020 |
| 8177 | 12/29/2020 | 53 | 2020 |
| 8178 | 12/30/2020 | 53 | 2020 |
| 8179 | 12/31/2020 | 53 | 2020 |
| 8180 | 01/01/2021 | 1 | 2021 |
| 8181 | 01/02/2021 | 1 | 2021 |
| 8182 | 01/03/2021 | 2 | 2021 |
| 8183 | 01/04/2021 | 2 | 2021 |
| 8184 | 01/05/2021 | 2 | 2021 |
| 8185 | 01/06/2021 | 2 | 2021 |
| 8186 | 01/07/2021 | 2 | 2021 |
Il campo 'week_year' viene creato nell'istruzione di caricamento precedente mediante l'uso della funzione weekyear() e trasferendo il campo data come argomento della funzione.
La variabile di sistema BrokenWeeks è impostata su 1, il che significa che l'applicazione utilizza settimane parziali. La settimana 1 inizia il 1° gennaio.
Schema dell'intervallo della funzione weekyear() con l'uso di settimane parziali
La transazione 8181 ha luogo il 2 gennaio, che fa parte della settimana 1. Pertanto, restituisce un valore di 2021 per il campo 'week_year'.