# year - funzione dello script e del grafico

Questa funzione restituisce un numero intero che rappresenta l'anno in cui expression viene interpretato come data in base all'interpretazione numerica standard.

Sintassi:

year(expression)

Tipo di dati restituiti: numero intero

La funzione `year()` è disponibile sia come funzione script che come grafico. La funzione restituisce l'anno per una data particolare. È comunemente utilizzata per creare un campo anno come dimensione in un Calendario principale.

## Casi di utilizzo

La funzione `year()` è utile quando si desidera confrontare le aggregazioni per anno. Ad esempio, la funzione potrebbe essere usata se si desidera visualizzare le vendite totali dei prodotti in base all'anno.

È possibile creare queste dimensioni anche nello script di caricamento utilizzando la funzione che consente di creare un campo in una tabella Calendario principale. In alternativa, può essere utilizzata direttamente in un grafico come dimensione calcolata.

Esempi di funzioni

| Esempio | Risultato |
| --- | --- |
| `year(<br>'2012-10-12' )` | restituisce 2012 |
| `year(<br>'35648' )` | restituisce 1997 poiché 35648 = 1997-08-06 |

## 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 1 – set di dati DateFormat (script)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.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 delle date, caricato in una tabella denominata `Master Calendar`.

* Viene utilizzata la variabile di sistema predefinita `DateFormat` MM/GG/AAAA.

* Un caricamento precedente, utilizzato per creare un campo aggiuntivo, denominato `year`, mediante la funzione `year()`.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';

Master_Calendar:

    Load
        date,
        year(date) as year
        ;
Load
date
Inline 
[
date
12/28/2020
12/29/2020
12/30/2020
12/31/2020
01/01/2021
01/02/2021
01/03/2021
01/04/2021
01/05/2021
01/06/2021
01/07/2021
];
```

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

* `date`

* `year`

Tabella dei risultati

| date | anno |
| --- | --- |
| 12/28/2020 | 2020 |
| 12/29/2020 | 2020 |
| 12/30/2020 | 2020 |
| 12/31/2020 | 2020 |
| 01/01/2021 | 2021 |
| 01/02/2021 | 2021 |
| 01/03/2021 | 2021 |
| 01/04/2021 | 2021 |
| 01/05/2021 | 2021 |
| 01/06/2021 | 2021 |
| 01/07/2021 | 2021 |

## Esempio 2 – Date ANSI

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.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 delle date, caricato in una tabella denominata `Master Calendar`.

* È utilizzata la variabile di sistema predefinita `DateFormat` (MM/GG/AAAA). Tuttavia, le date incluse nel set di dati sono nel formato data standard ANSI.

* Un caricamento precedente, utilizzato per creare un campo aggiuntivo, denominato `year`, mediante la funzione `year()`.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';

Master_Calendar:
    Load
        date,
        year(date) as year
        ;
Load
date
Inline 
[
date
2020-12-28
2020-12-29
2020-12-30
2020-12-31
2021-01-01
2021-01-02
2021-01-03
2021-01-04
2021-01-05
2021-01-06
2021-01-07
];
```

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

* `date`

* `year`

Tabella dei risultati

| date | anno |
| --- | --- |
| 2020-12-28 | 2020 |
| 2020-12-29 | 2020 |
| 2020-12-30 | 2020 |
| 2020-12-31 | 2020 |
| 2021-01-01 | 2021 |
| 2021-01-02 | 2021 |
| 2021-01-03 | 2021 |
| 2021-01-04 | 2021 |
| 2021-01-05 | 2021 |
| 2021-01-06 | 2021 |
| 2021-01-07 | 2021 |

## Esempio 3 – Date non formattate

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.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 delle date in formato numerico, caricato in una tabella denominata `Master Calendar`.

* È utilizzata la variabile di sistema predefinita `DateFormat` (MM/GG/AAAA).

* Un caricamento precedente, utilizzato per creare un campo aggiuntivo, denominato `year`, mediante la funzione `year()`.

Viene caricata la data originale non formattata, denominata `unformatted_date`, e per maggiore chiarezza, viene utilizzato un ulteriore campo aggiuntivo, denominato `long_date`, per convertire la data numerica in un campo data formattato utilizzando la funzione `date()`.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';

Master_Calendar:
    Load
        unformatted_date,
        date(unformatted_date) as long_date,
        year(unformatted_date) as year
        ;
Load
unformatted_date
Inline 
[
unformatted_date
44868
44898
44928
44958
44988
45018
45048
45078
45008
45038
45068
];
```

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

* `unformatted_date`

* `long_date`

* `year`

Tabella dei risultati

| unformatted\_date | long\_date | anno |
| --- | --- | --- |
| 44868 | 11/03/2022 | 2022 |
| 44898 | 12/03/2022 | 2022 |
| 44928 | 01/02/2023 | 2023 |
| 44958 | 02/01/2023 | 2023 |
| 44988 | 03/03/2023 | 2023 |
| 45008 | 03/23/2023 | 2023 |
| 45018 | 04/02/2023 | 2023 |
| 45038 | 04/22/2023 | 2023 |
| 45048 | 05/02/2023 | 2023 |
| 45068 | 05/22/2023 | 2023 |
| 45078 | 06/01/2023 | 2023 |

## Esempio 4 – Esempio di oggetto grafico

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

#### Script di caricamento ed espressione del grafico

Panoramica

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

In questo esempio, un insieme di dati relativi agli ordini effettuati viene caricato in una tabella denominata Vendite. La tabella contiene tre campi:

* id

* sales\_date

* amount

Le garanzie sulle vendite dei prodotti durano due anni dalla data di vendita. L'attività consiste nel creare una misura in un grafico per determinare l'anno in cui scadrà ogni garanzia.

Script di caricamento

```
Sales:
Load
id,
sales_date,
amount
Inline 
[
id,sales_date,amount
1,12/28/2020,231.24,
2,12/29/2020,567.28,
3,12/30/2020,364.28,
4,12/31/2020,575.76,
5,01/01/2021,638.68,
6,01/02/2021,785.38,
7,01/03/2021,967.46,
8,01/04/2021,287.67
9,01/05/2021,764.45,
10,01/06/2021,875.43,
11,01/07/2021,957.35
];
```

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione: sales\_date.

Creare la seguente misura:

=year(sales\_date+365\*2)

Tabella dei risultati

| sales\_date | =year(sales\_date+365\*2) |
| --- | --- |
| 12/28/2020 | 2022 |
| 12/29/2020 | 2022 |
| 12/30/2020 | 2022 |
| 12/31/2020 | 2022 |
| 01/01/2021 | 2023 |
| 01/02/2021 | 2023 |
| 01/03/2021 | 2023 |
| 01/04/2021 | 2023 |
| 01/05/2021 | 2023 |
| 01/06/2021 | 2023 |
| 01/07/2021 | 2023 |

I risultati di questa misura sono riportati nella tabella precedente. Per aggiungere due anni a una data, moltiplicare 365 per 2 e aggiungere il risultato alla data di vendita. Pertanto, le vendite avvenute nel 2020 hanno come anno di scadenza il 2022.