Vai al contenuto principale Passa a contenuto complementare

yearname - funzione dello script e del grafico

Questa funzione restituisce un anno di quattro cifre come valore di visualizzazione con un valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno dell'anno contenente date.

Diagramma dell'intervallo di tempo della funzione yearname().

Diagramma che mostra l'intervallo di tempo in cui la funzione yearname restituirà un risultato.

La funzione yearname() è diversa dalla funzione year() in quanto consente di compensare la data che si desidera valutare e di impostare il primo mese dell'anno.

Se il primo mese dell'anno non è gennaio, la funzione restituirà quattro cifre per i due anni nel periodo di dodici mesi che contengono la data. Ad esempio, se l'anno inizia ad aprile e la data da valutare è il giorno 30/06/2020, il risultato restituito è 2020-2021.

Lo schema della funzione yearname() con aprile impostato come primo mese dell'anno.

Diagramma che mostra che la funzione yearname può identificare date comprese in un periodo di dodici mesi e che il risultato  ritorno può dipendere da quale mese è impostato come primo mese dell'anno.

Sintassi:  

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

Tipo di dati restituiti: duale

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. Il valore visualizzato sarà quindi una stringa che mostrerà due anni.

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

valori first_month_of_year
Month Valore
Febbraio 2
March 3
April 4
May 5
June 6
July 7
August 8
September 9
October 10
Novembre 11
December 12

La funzione yearname() è utile per confrontare le aggregazioni per anno. Ad esempio, può essere usata se si desidera visualizzare le vendite totali dei prodotti in base all'anno.

È possibile creare queste dimensioni nello script di caricamento utilizzando la funzione che consente di creare un campo in una tabella Calendario principale. Inoltre, possono essere create in un grafico come dimensioni calcolate.

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
yearname('10/19/2001') Restituisce '2001.'
yearname('10/19/2001',-1) Restituisce '2000'.
yearname('10/19/2001',0,4) Restituisce '2001-2002'.
Argomenti correlati
Argomento Descrizione
year - funzione dello script e del grafico Questa funzione restituisce un numero intero che rappresenta l'anno in cui l'espressione viene interpretat come data in base all'interpretazione numerica standard.

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!