Vai al contenuto principale Passa a contenuto complementare

yearstart - funzione dello script e del grafico

Questa funzione restituisce un indicatore temporale corrispondente all'inizio del primo giorno dell'anno contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.

Sintassi:  

YearStart(date[, period_no[, first_month_of_year]])

In altre parole, la funzione yearstart() determina in quale anno cade la data. Quindi, restituisce data e ora, nel formato data, per il primo millisecondo di quell'anno. Il primo mese dell'anno è, per impostazione predefinita, gennaio. Tuttavia, è possibile modificare il mese da impostare come primo utilizzando l'argomento first_month_of_year nella funzione yearstart().

Diagramma della funzione yearstart() che mostra l'intervallo di tempo che la funzione può coprire.

Diagramma che mostra la funzione yearstart() che identifica le date all'interno di un determinato periodo di anno e restituisce data e ora dell'inizio dell'anno per le date che cadono in quell'anno specifico.

La funzione yearstart() viene utilizzata come parte di un'espressione quando si desidera che il calcolo utilizzi la frazione dell'anno trascorso fin'ora. Ad esempio, se si desidera calcolare l'interesse accumulato in un anno a oggi.

Tipo di dati restituiti: duale

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

I mesi seguenti possono essere utilizzati in first_month_of_year argument:

valori first_month_of_year
Month Value
February  2
March 3
April 4
May 5
June 6
July 7
August 8
September 9
October 10
November  11
December 12

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
yearstart('10/19/2001') Restituisce 01/01/2001 00:00:00.
yearstart('10/19/2001',-1) Restituisce 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4) Restituisce 04/01/2001 00:00:00.

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!