Vai al contenuto principale Passa a contenuto complementare

monthsstart - funzione dello script e del grafico

Questa funzione restituisce un valore corrispondente a un indicatore temporale recante il primo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base. È inoltre possibile individuare l'indicatore temporale per un periodo di tempo precedente o successivo.Il formato di output predefinito è il formato DateFormat impostato nello script.

Sintassi:  

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

Tipo di dati restituiti: duale

Schema della funzione monthsstart().

Schema esemplificativo che mostra come ogni elemento della funzione collabori per restituire il risultato del timestamp.

La funzione monthsstart() divide l'anno in segmenti in base all'argomento n_months fornito. Quindi valuta in quale segmento rientra ogni data fornita e restituisce il primo millisecondo, in formato data, di quel segmento. La funzione offre anche la possibilità di restituire il timestamp iniziale dai segmenti precedenti o successivi, oltre a ridefinire qual è 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 monthsstart() viene comunemente utilizzata come parte di un'espressione quando l'utente desidera che il calcolo utilizzi la frazione di un periodo non ancora trascorso. Questo potrebbe essere utilizzato, ad esempio, per fornire una variabile di input che consenta all'utente di calcolare il totale degli interessi accumulati fino a quel momento nel mese, nel trimestre o nel semestre.

Esempi di funzioni
Esempio Risultato
monthsstart(4, '10/19/2013') Restituisce 09/01/2013.
monthsstart(4, '10/19/2013, -1) Restituisce 05/01/2013.
monthsstart(4, '10/19/2013', 0, 2 ) Restituisce 10/01/2013, poiché l'inizio dell'anno corrisponde al mese 2.

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 - Nessun argomento aggiuntivo

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!