Vai al contenuto principale

yearend - funzione dello script e del grafico

Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno dell'anno contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.

Sintassi:  

YearEnd( date[, period_no[, first_month_of_year = 1]])

In altre parole, la funzione yearend() determina in quale anno cade la data. Quindi, restituisce data e ora, nel formato data, per l'ultimo 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 yearend().

Nota informatica La funzione yearend() non considera la variabile di sistema FirstMonthOfYear. L'anno inizia il 1 gennaio a condizione che l'argomento first_month_of_year non venga utilizzato per modificarlo.

Schema della funzione yearend().

Diagramma che mostra come la funzione yearend() identifica una data e la fine dell'anno in cui si svolge.

La funzione yearend() viene utilizzata come parte di un'espressione quando si desidera che il calcolo utilizzi la frazione dell'anno non ancora trascorso. Ad esempio, se si vuole calcolare l'interesse totale non ancora maturato durante l'anno.

Tipo di dati restituiti: duale

Argomenti
Argomento Descrizione
date La data 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.

È possibile utilizzare i seguenti valori per impostare il primo mese dell'anno nell'argomento first_month_of_year:

valori first_month_of_year
Mese Valore
Febbraio 2
March 3
Aprile 4
May 5
Giugno 6
Luglio 7
Agosto 8
Settembre 9
Ottobre 10
Novembre 11
Dicembre 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 regionali delle app.

Le impostazioni regionali predefinite nelle app si basano su una combinazione di impostazioni del provider di identità, impostazioni di sistema o impostazioni del browser. 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 proprie impostazioni regionali preferite per la creazione di app.

Esempi di funzioni
Esempio Risultato
yearend('10/19/2001') Returns 12/31/2001 23:59:59.
yearend('10/19/2001', -1) Returns 12/31/2000 23:59:59.
yearend('10/19/2001', 0, 4) Returns 03/31/2002 23:59:59.

Esempio 1 - Nessun argomento aggiuntivo

Esempio 2 – period_no

Esempio 3 – first_month_of_year

Esempio 4 - Esempio di oggetto grafico

Esempio 5 – Scenario