Vai al contenuto principale Passa a contenuto complementare

weekyear - funzione dello script e del grafico

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

Argomenti
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()

Schema che mostra l'intervallo di tempo valutato dalla 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

Schema che mostra come funziona la funzione weekyear() con le settimane intere.

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.

Esempi di funzioni
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
Argomenti correlati
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

Esempio 2 - Settimane intere

Esempio 3 - Esempio di oggetto grafico

Esempio 4 - Scenario

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!