# yearname - Funzione per script e grafici

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 dell'intervallo di tempo della funzione `yearname()`.

Diagramma dell'intervallo di tempo della funzione `yearname()`yearname(). ![Diagramma che mostra l'intervallo di tempo in cui la funzione yearname restituirà un risultato.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram1.png)

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.

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

Lo schema della funzione `yearname()`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.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram2.png)

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

| Mese | Valore |
| --- | --- |
| Febbraio | 2 |
| Marzo | 3 |
| Aprile | 4 |
| Maggio | 5 |
| Giugno | 6 |
| Luglio | 7 |
| Agosto | 8 |
| Settembre | 9 |
| Ottobre | 10 |
| Novembre | 11 |
| Dicembre | 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.

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 per script e grafici](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm) | 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

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Script di caricamento e risultati

Panoramica

Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.

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`

Tabella dei risultati

| date | 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.

Diagramma della funzione `yearname()` che mostra il 2021 come valore per l'anno.

Diagramma della funzione `yearname()`yearname() che mostra il 2021 come valore per l'anno.![Il diagramma che mostra la funzione yearname() restituisce 2021 per la data del 17 marzo 2021.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example1-diagram.png)

## Esempio 2 – period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Script di caricamento e risultati

Panoramica

Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.

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`

Tabella dei risultati

| date | 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`.

Schema della funzione `yearname()` con il valore `period_no` con un impostato su `-1`.

Schema della funzione `yearname()`yearname() con il valore `period_no`period\_no con un impostato su `-1`-1.![Diagramma che mostra come il valore period_no di meno uno cambia gli intervalli di tempo identificati dalla funzione yearname().](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example2-diagram.png)

## Esempio 3 – first\_month\_of\_year

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Script di caricamento e risultati

Panoramica

Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.

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`

Tabella dei risultati

| date | 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.

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

Lo schema della funzione `yearname()`yearname() con marzo impostato come primo mese dell'anno.![Diagramma che mostra l'intervallo di tempo identificato dalla funzione yearname() quando il primo mese dell'anno è impostato su marzo.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example3-diagram.png)

## Esempio 4 - Esempio di oggetto grafico

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Script di caricamento ed espressione del grafico

Panoramica

Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.

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)`

Tabella dei risultati

| date | =yearname(data) |
| --- | --- |
| 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.

Diagramma della funzione `yearname()` con 2021 come valore per l'anno.

Diagramma della funzione `yearname()`yearname() con 2021 come valore per l'anno.![Diagramma che mostra che la funzione yearname()  restituisce  2021 come valore per l'anno](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example4-diagram.png)

## Esempio 5 – Scenario

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Script di caricamento ed espressione del grafico

Panoramica

Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.

Lo script di caricamento contiene:

* Lo stesso set di dati dal primo esempio.

* La variabile di sistema DateFormat che è impostata su 'MM/DD/YYYY'.

L'utente finale desidera un grafico che presenta le vendite totali per trimestre per le transazioni. Utilizzare la funzione yearname() come dimensione calcolata per creare questo grafico quando la dimensione yearname() non è disponibile nel modello dati.

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.

Per confrontare le aggregazioni per anno, creare la seguente dimensione calcolata:

=yearname(date)

Creare questa misura:

=sum(amount)

Impostare la misura Formattazione numero su Denaro.

Tabella dei risultati

| yearname(date) | sum(amount) |
| --- | --- |
| 2020 | $463.55 |
| 2021 | $457.69 |
| 2022 | $294.35 |