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().
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.
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:
| Month | Valore |
|---|---|
| Febbraio | 2 |
| March | 3 |
| April | 4 |
| May | 5 |
| June | 6 |
| July | 7 |
| August | 8 |
| September | 9 |
| October | 10 |
| Novembre | 11 |
| December | 12 |
Casi di utilizzo
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.
Le impostazioni regionali predefinite delle app si basano sulle impostazioni regionali del sistema del computer o del server in cui risulta installato Qlik Sense. Se il server Qlik Sense a cui si accede è impostato in Svezia, l'editor caricamento dati utilizzerà le impostazioni regionali svedesi per date, ora e valuta. Queste impostazioni di formato regionale non riguardano la lingua visualizzata nell'interfaccia utente Qlik Sense. Qlik Sense verrà visualizzato nella stessa lingua del browser utilizzato.
| Esempio | Risultato |
|---|---|
| yearname('10/19/2001') | Restituisce '2001.' |
| yearname('10/19/2001',-1) | Restituisce '2000'. |
| yearname('10/19/2001',0,4) | Restituisce '2001-2002'. |
| 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
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Un set di dati contenente un insieme di transazioni tra il 2020 e il 2022 viene caricato in una tabella denominata 'Transactions'.
-
La variabile di sistema DateFormat che è impostata su 'MM/DD/YYYY'.
-
Un'istruzione di caricamento precedente che utilizza yearname() e ne imposta il valore come campo year_name.
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearname(date) as year_name
;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
date
-
year_name
| data | year_name |
|---|---|
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |
Il campo 'year_name' viene creato nell'istruzione di caricamento precedente mediante l'uso della funzione yearname() e trasferendo il campo data come argomento della funzione.
La funzione yearname() identifica l'anno in cui rientra il valore della data e lo restituisce come valore anno a quattro cifre.
Diagramma della funzione yearname() che mostra il 2021 come valore per l'anno.
Esempio 2 – period_no
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Un set di dati contenente un insieme di transazioni tra il 2020 e il 2022 caricato in una tabella denominata 'Transazioni'.
-
La variabile di sistema DateFormat impostata su 'MM/DD/YYYY'.
-
Un'istruzione di caricamento precedente che utilizza yearname() e ne imposta il valore come campo year_name.
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearname(date,-1) as prior_year_name
;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
date
-
prior_year_name
| data | prior_year_name |
|---|---|
| 01/13/2020 | 2019 |
| 02/26/2020 | 2019 |
| 03/27/2020 | 2019 |
| 04/16/2020 | 2019 |
| 05/21/2020 | 2019 |
| 08/14/2020 | 2019 |
| 10/07/2020 | 2019 |
| 12/05/2020 | 2019 |
| 01/22/2021 | 2020 |
| 02/03/2021 | 2020 |
| 03/17/2021 | 2020 |
| 04/23/2021 | 2020 |
| 05/04/2021 | 2020 |
| 06/30/2021 | 2020 |
| 07/26/2021 | 2020 |
| 12/27/2021 | 2020 |
| 06/06/2022 | 2021 |
| 07/18/2022 | 2021 |
| 11/14/2022 | 2021 |
| 12/12/2022 | 2021 |
Poiché il valore period_no di -1 viene utilizzato come argomento offset nella funzione yearname(), la funzione per prima cosa identifica l'anno in cui avvengono le transazioni. La funzione quindi si sposta di un anno prima e restituisce l'anno risultante.
Schema della funzione yearname() con il valore period_no con un impostato su -1.
Esempio 3 – first_month_of_year
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Lo stesso set di dati dal primo esempio.
-
La variabile di sistema DateFormat che è impostata su 'MM/DD/YYYY'.
-
Un'istruzione di caricamento precedente che utilizza yearname() e ne imposta il valore come campo year_name.
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearname(date,0,4) as year_name
;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
-
id
-
date
-
year_name
| data | year_name |
|---|---|
| 01/13/2020 | 2019-2020 |
| 02/26/2020 | 2019-2020 |
| 03/27/2020 | 2019-2020 |
| 04/16/2020 | 2020-2021 |
| 05/21/2020 | 2020-2021 |
| 08/14/2020 | 2020-2021 |
| 10/07/2020 | 2020-2021 |
| 12/05/2020 | 2020-2021 |
| 01/22/2021 | 2020-2021 |
| 02/03/2021 | 2020-2021 |
| 03/17/2021 | 2020-2021 |
| 04/23/2021 | 2021-2022 |
| 05/04/2021 | 2021-2022 |
| 06/30/2021 | 2021-2022 |
| 07/26/2021 | 2021-2022 |
| 12/27/2021 | 2021-2022 |
| 06/06/2022 | 2022-2023 |
| 07/18/2022 | 2022-2023 |
| 11/14/2022 | 2022-2023 |
| 12/12/2022 | 2022-2023 |
Poiché l'argomento first_month_of_year di 4 viene utilizzato nella funzione yearname(), l'inizio dell'anno va dal 1 gennaio al 1 aprile. Pertanto, ogni periodo di dodici mesi attraversa due anni civili e la funzione yearname() restituisce i due anni con formato a quattro cifre anni per le date valutate.
La transazione 8198 avviene il 17 marzo 2021. La funzione yearname() imposta l'inizio dell'anno il 1 aprile e la fine il 30 marzo. Pertanto, la transazione 8198 è avvenuta nel periodo dell'anno dal 1 aprile 2020 al 30 marzo 2021. Di conseguenza, la funzione yearname() restituisce il valore 2020-2021.
Lo schema della funzione yearname() con marzo impostato come primo mese dell'anno.
Esempio 4 - Esempio di oggetto grafico
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
-
Lo stesso set di dati dal primo esempio.
-
La variabile di sistema DateFormat che è impostata su 'MM/DD/YYYY'.
Tuttavia, il campo che restituisce l'anno in cui è avvenuta la transazione viene creato come misura in un oggetto grafico.
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
]; Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione:
date
Per calcolare il campo 'year_name', creare questa misura:
=yearname(date)
| data | =yearname(date) |
|---|---|
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |
La misura 'year_name' viene creata nell'oggetto grafico utilizzando la funzione yearname() e trasferendo il campo data come argomento della funzione.
La funzione yearname() identifica l'anno in cui rientra il valore della data e lo restituisce come valore anno a quattro cifre.
Diagramma della funzione yearname() con 2021 come valore per l'anno.
