Vai al contenuto principale Passa a contenuto complementare

weekname - funzione dello script e del grafico

Questa funzione restituisce un valore che mostra l'anno e il numero della settimana con un valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno della settimana contenente date.

Sintassi:  

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

La funzione weekname() determina la settimana in cui cade la data e restituisce il numero della settimana e l'anno per quella settimana. Il primo giorno della settimana è determinato dalla variabile di sistema FirstWeekDay. Tuttavia, è possibile anche modificare il primo giorno della settimana utilizzando l'argomento first_week_day nella funzione weekname().

 In Qlik Sense, le impostazioni regionali vengono recuperate alla creazione dell'app e le impostazioni corrispondenti vengono memorizzate nello script come variabili d'ambiente.

Uno sviluppatore di app nordamericano ottiene spesso Set BrokenWeeks=1; nello script, corrispondente a settimane interrotte. Uno sviluppatore di app europeo ottiene spesso Set BrokenWeeks=0; nello script, corrispondente a settimane intere.

Se l'applicazione utilizza settimane interrotte, il conteggio del numero di settimane inizia il 1° gennaio e termina il giorno precedente alla variabile di sistema FirstWeekDay, indipendentemente dal numero di giorni trascorsi.

Tuttavia, se l'applicazione utilizza settimane ininterrotte, la settimana 1 può iniziare nell'anno precedente o nei primi giorni di gennaio. Dipende da come si utilizzano le variabili di sistema ReferenceDay e FirstWeekDay.

Esempio di funzione Weekname
Data Nome settimana ISO Nome settimana US
Sab 26 dic 2020 2020/52 2020/52
Dom 27 dic 2020 2020/52 2020/53
Lun 28 dic 2020 2020/53 2020/53
Mar 29 dic 2020 2020/53 2020/53
Mer 30 dic 2020 2020/53 2020/53
Gio 31 dic 2020 2020/53 2020/53
Ven 1° gen 2021 2020/53 2021/01
Sab 2 gen 2021 2020/53 2021/01
Dom 3 gen 2021 2020/53 2021/02
Lun 4 gen 2021 2021/01 2021/02
Mar 5 gen 2021 2021/01 2021/02

La funzione weekname() è utile per confrontare le aggregazioni per settimane.

Ad esempio, può essere usata se si desidera visualizzare le vendite totali dei prodotti in base alla settimana. Per mantenere la coerenza con la variabile di ambiente BrokenWeeks nell'applicazione, utilizzare weekname() anziché lunarweekname(). Se l'applicazione utilizza settimane ininterrotte, la settimana 1 può contenere date di dicembre dell'anno precedente o escludere date di gennaio dell'anno in corso. Se l'applicazione utilizza settimane interrotte, la settimana 1 può contenere meno di sette giorni.

Tipo di dati restituiti: duale

Argomenti
Argomento Descrizione
timestamp La data o la data e ora da valutare.
period_no shift è un numero intero, in cui il valore 0 indica la settimana che contiene date. I valori negativi di shift indicano le settimane precedenti, mentre i valori positivi indicano le settimane successive.
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.

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.

Gli esempi riportati di seguito presuppongono:

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Esempi di funzioni
Esempio Risultato
weekname('01/12/2013') Restituisce 2013/02.
weekname('01/12/2013', -1) Restituisce 2013/01.
weekname('01/12/2013', 0, 1) Restituisce 2013/02.

Esempio 1 - Nessun argomento aggiuntivo

Esempio 2 – period_no

Esempio 3 – first_week_day

Esempio 4 – Esempio di oggetto grafico

Esempio 5 – 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!