Questa funzione restituisce un valore di visualizzazione che rappresenta l'intervallo dei mesi del periodo (formattati in base alla variabile di script MonthNames) e l'anno. Il valore numerico sottostante corrisponde a un indicatore temporale recante il primo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base.
La funzione monthsname() divide l'anno in segmenti in base all'argomento n_months fornito. Quindi, valuta il segmento a cui appartiene ogni valore date fornito e restituisce i nomi del mese di inizio e di fine di quel segmento, nonché l'anno. La funzione offre anche la possibilità di restituire questi limiti dai segmenti precedenti o successivi, oltre a ridefinire quale è il primo mese dell'anno.
I seguenti segmenti dell'anno sono disponibili nella funzione come argomenti di n_month :
Possibili argomenti di n_month
Periodi
Numero di mesi
mese
1
bimestre
2
trimestre
3
quattro mesi
4
semestre
6
Argomenti
Argomento
Descrizione
n_months
Il numero di mesi che definisce il periodo. Un numero intero o un'espressione la cui risoluzione è un numero intero corrispondente a: 1 (equivalente alla funzione inmonth()), 2 (bimestre), 3 (equivalente alla funzione inquarter()), 4 (quadrimestre) o 6 (semestre).
date
La data o la data e ora da valutare.
period_no
Il periodo può essere differito mediante period_no, un numero intero, o un'espressione la cui risoluzione è un numero intero, in cui il valore 0 indica il periodo che contiene base_date. I valori negativi di period_no indicano i periodi precedenti, mentre i valori positivi indicano i periodi successivi.
first_month_of_year
Se si intende utilizzare anni (fiscali) che non iniziano a gennaio, indicare un valore compreso tra 2 e 12 in first_month_of_year.
Casi di utilizzo
La funzione monthsname() è utile quando si desidera fornire all'utente la funzionalità per confrontare le aggregazioni in base a un periodo di sua scelta. Ad esempio, è possibile fornire una variabile di input per consentire all'utente di visualizzare le vendite totali dei prodotti per mese, trimestre o semestre.
Queste dimensioni possono essere create nello script di caricamento aggiungendo la funzione come campo in una tabella Calendario principale o, in alternativa, creando la dimensione direttamente in un grafico come dimensione calcolata.
Esempi di funzioni
Esempio
Risultato
monthsname(4, '10/19/2013')
Restituisce 'Sep-Dec 2013'. In questo e in altri esempi, l'istruzione SET Monthnames è impostata su Jan;Feb;Mar e così via.
monthsname(4, '10/19/2013', -1)
Restituisce 'May-Aug 2013'.
monthsname(4, '10/19/2013', 0, 2)
Restituisce 'Oct-Jan 2014', poiché come mese di inizio anno è stato specificato 2. Quindi, il periodo di quattro mesi termina il primo mese dell'anno successivo.
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.
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 2022, caricato in una tabella denominata 'Transactions'.
Il campo della data fornito nel formato della variabile di sistema DateFormat (MM/GG/AAAA).
La creazione di un campo, bi_monthly_range, che raggruppa le transazioni in segmenti bimestrali e restituisce i nomi limite di quel segmento per ogni transazione.
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
bi_monthly_range
Tabella dei risultati
data
bi_monthly_range
2/19/2022
Gen-Feb 2022
3/7/2022
Mar-Apr 2022
3/30/2022
Mar-Apr 2022
4/5/2022
Mar-Apr 2022
4/16/2022
Mar-Apr 2022
5/1/2022
Mag-Giu 2022
5/7/2022
Mag-Giu 2022
5/22/2022
Mag-Giu 2022
6/15/2022
Mag-Giu 2022
6/26/2022
Mag-Giu 2022
7/9/2022
Lug-Ago 2022
7/22/2022
Lug-Ago 2022
7/23/2022
Lug-Ago 2022
7/27/2022
Lug-Ago 2022
8/2/2022
Lug-Ago 2022
8/8/2022
Lug-Ago 2022
8/19/2022
Lug-Ago 2022
9/26/2022
Set-Ott 2022
10/14/2022
Set-Ott 2022
10/29/2022
Set-Ott 2022
Il campo bi_monthly_range viene creato nell'istruzione caricamento precedente utilizzando la funzione monthsname(). Il primo argomento fornito è 2, dividendo l'anno in segmenti bimestrali. Il primo argomento identifica il campo da valutare.
La transazione 8195 è avvenuta il 22 maggio. La funzione monthsname() divide inizialmente l'anno in segmenti bimestrali. La transazione 8195 rientra nel segmento tra il 1 maggio e il 30 giugno. Pertanto, la funzione restituisce questi mesi nel formato della variabile di sistema MonthNames, nonché l'anno, maggio-giugno 2022.
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:
Vengono utilizzati lo stesso set di dati inline e lo stesso scenario del primo esempio.
La creazione di un campo, prev_bi_monthly_range, che raggruppa le transazioni in segmenti bimestrali e restituisce i nomi limite del segmento precedente per ogni transazione.
Aggiungere qui altro testo, se necessario, con elenchi, ecc.
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
prev_bi_monthly_range
Tabella dei risultati
data
prev_bi_monthly_range
2/19/2022
Nov-Dic 2021
3/7/2022
Gen-Feb 2022
3/30/2022
Gen-Feb 2022
4/5/2022
Gen-Feb 2022
4/16/2022
Gen-Feb 2022
5/1/2022
Mar-Apr 2022
5/7/2022
Mar-Apr 2022
5/22/2022
Mar-Apr 2022
6/15/2022
Mar-Apr 2022
6/26/2022
Mar-Apr 2022
7/9/2022
Mag-Giu 2022
7/22/2022
Mag-Giu 2022
7/23/2022
Mag-Giu 2022
7/27/2022
Mag-Giu 2022
8/2/2022
Mag-Giu 2022
8/8/2022
Mag-Giu 2022
8/19/2022
Mag-Giu 2022
9/26/2022
Lug-Ago 2022
10/14/2022
Lug-Ago 2022
10/29/2022
Lug-Ago 2022
In questo esempio, -1 viene utilizzato come argomento period_no nella funzione monthsname(). Dopo aver inizialmente diviso un anno in segmenti bimestrali, la funzione restituisce quindi i limiti del segmento precedente per il momento in cui avviene una transazione.
La transazione 8195 è stata effettuata nel segmento tra maggio e giugno. Pertanto, il segmento bimestrale precedente è compreso tra il 1 marzo e il 30 aprile, quindi la funzione restituisce Mar-Apr 2022.
Esempio 3 – first_month_of_year
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Vengono utilizzati lo stesso set di dati inline e lo stesso scenario del primo esempio.
La creazione di un campo differente, bi_monthly_range, che raggruppa le transazioni in segmenti bimestrali e restituisce i limiti del segmento per ogni transazione.
Tuttavia, in questo esempio, dobbiamo anche impostare aprile come primo mese dell'anno finanziario.
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
bi_monthly_range
Tabella dei risultati
data
bi_monthly_range
2/19/2022
Feb-Mar 2021
3/7/2022
Feb-Mar 2021
3/30/2022
Feb-Mar 2021
4/5/2022
Apr-Mag 2022
4/16/2022
Apr-Mag 2022
5/1/2022
Apr-Mag 2022
5/7/2022
Apr-Mag 2022
5/22/2022
Apr-Mag 2022
6/15/2022
Giu-Lug 2022
6/26/2022
Giu-Lug 2022
7/9/2022
Giu-Lug 2022
7/22/2022
Giu-Lug 2022
7/23/2022
Giu-Lug 2022
7/27/2022
Giu-Lug 2022
8/2/2022
Ago-Set 2022
8/8/2022
Ago-Set 2022
8/19/2022
Ago-Set 2022
9/26/2022
Ago-Set 2022
10/14/2022
Ott-Nov 2022
10/29/2022
Ott-Nov 2022
Utilizzando 4 come argomento first_month_of_year nella funzione monthsname(), la funzione inizia l'anno il 1 aprile, quindi divide l'anno in segmenti bimestrali: Apr-May,Jun-Jul,Aug-Sep,Oct-Nov,Dec-Jan,Feb-Mar.
Testo del paragrafo per i Risultati.
La transazione 8195 è avvenuta il 22 maggio e rientra nel segmento tra il 1 aprile e il 31 maggio. Pertanto, la funzione restituisce Apr-Mag 2022.
Esempio 4 - Esempio di oggetto grafico
Panoramica
Aprire l'Editor di caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento utilizza lo stesso set di dati inline e lo stesso scenario del primo esempio. Tuttavia, in questo esempio, il set di dati invariato viene caricato nell'applicazione. Il calcolo che raggruppa le transazioni in segmenti bimestrali e restituisce i limiti del segmento per ogni transazione viene creato come una misura in un oggetto grafico dell'applicazione.
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione:date.
Creare la seguente misura:
=monthsname(2,date)
Tabella dei risultati
data
=monthsname(2,date)
2/19/2022
Gen-Feb 2022
3/7/2022
Mar-Apr 2022
3/30/2022
Mar-Apr 2022
4/5/2022
Mar-Apr 2022
4/16/2022
Mar-Apr 2022
5/1/2022
Mag-Giu 2022
5/7/2022
Mag-Giu 2022
5/22/2022
Mag-Giu 2022
6/15/2022
Mag-Giu 2022
6/26/2022
Mag-Giu 2022
7/9/2022
Lug-Ago 2022
7/22/2022
Lug-Ago 2022
7/23/2022
Lug-Ago 2022
7/27/2022
Lug-Ago 2022
8/2/2022
Lug-Ago 2022
8/8/2022
Lug-Ago 2022
8/19/2022
Lug-Ago 2022
9/26/2022
Set-Ott 2022
10/14/2022
Set-Ott 2022
10/29/2022
Set-Ott 2022
Il campo bi_monthly_range viene creato come misura nell'oggetto grafico mediante l'utilizzo della funzione monthsname(). Il primo argomento fornito è 2, dividendo l'anno in segmenti bimestrali. Il primo argomento identifica il campo da valutare.
La transazione 8195 è avvenuta il 22 maggio. La funzione monthsname() divide inizialmente l'anno in segmenti bimestrali. La transazione 8195 rientra nel segmento tra il 1 maggio e il 30 giugno. Pertanto, la funzione restituisce questi mesi nel formato della variabile di sistema , nonché l'anno, maggio-giugno 2022.MonthNames
Esempio 5 – Scenario
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 le transazioni per il 2022, caricato in una tabella denominata Transactions.
Il campo della data fornito nel formato della variabile di sistema DateFormat (MM/GG/AAAA).
L'utente finale vuole creare un oggetto grafico che visualizzi le vendite totali per un periodo selezionato. Questo può essere ottenuto anche quando la dimensione non è disponibile nel modello dati, utilizzando la funzione monthsname() come dimensione calcolata che viene modificata dinamicamente da un controllo di input variabile.
All'inizio dello script di caricamento, viene creata una variabile (vPeriod) che sarà collegata al controllo di input della variabile. Quindi, configurare la variabile come oggetto personalizzato nel foglio.
Procedere come indicato di seguito:
Nel pannello delle risorse, fare clic su Oggetti personalizzati.
Selezionare Dashboard bundle Qlik e creare un oggetto input variabile.
Immettere un titolo per l'oggetto grafico.
In Variabile, selezionare vPeriod come Nome e impostare l'oggetto in modo che venga visualizzato come elenco a discesa.
In Valori, configurare l'oggetto in modo che utilizzi valori dinamici. Inserire quanto segue:
Creare una nuova tabella e aggiungere la seguente dimensione calcolata:
=monthsname($(vPeriod),date)
Aggiungere questa misura per calcolare le vendite totali:
=sum(amount)
Impostare la Formattazione numero della misura su Denaro. Fare clic su Termina modifica. È ora possibile modificare i dati mostrati nella tabella regolando il segmento temporale nell'oggetto della variabile.
Ecco come apparirà la tabella dei risultati quando l'opzione tertial è selezionata:
Tabella dei risultati
monthsname($(vPeriod),date)
sum(amount)
Gen-Apr 2022
253.89
Mag-ago 2022
713.58
Set-Dic 2022
248.12
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!