Vai al contenuto principale Passa a contenuto complementare

monthsname - funzione dello script e del grafico

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.

Sintassi:  

MonthsName(n_months, date[, period_no[, first_month_of_year]])

Tipo di dati restituiti: duale

Schema della funzione monthname

Diagramma di esempio che mostra l'intervallo di mesi restituito dalla funzione monthname, data una data di input specifica.

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.

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 1 – Esempio di base

Esempio 2 – period_no

Esempio 3 – first_month_of_year

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!