# quartername Funzione per script e grafici

Questa funzione restituisce un valore di visualizzazione che mostra i mesi del trimestre (formattati in base alla variabile di script MonthNames) e l'anno con valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno del trimestre.

Sintassi:

QuarterName(date[, period\_no[, first\_month\_of\_year]])

Tipo di dati restituiti: duale

Schema della funzione `quartername()`.

Schema della funzione `quartername()`.

Schema della funzione `quartername()`quartername(). ![Schema di esempio che mostra come la funzione quartername converte una data di input in un intervallo di mesi contenuti nel trimestre in cui si verifica la data.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

In altre parole, la funzione `quartername()` determina in quale trimestre ricadrà la data. Restituisce quindi un valore che mostra i mesi iniziali e finali di questo trimestre e dell'anno. Il valore numerico sottostante di questo risultato è il primo millisecondo del trimestre.

Argomenti

| 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 il trimestre che contiene date. I valori negativi di period\_no indicano i trimestri precedenti, mentre i valori positivi indicano i trimestri 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. |

## Quando usare quartername

La funzione `quartername()` è utile quando si desidera confrontare le aggregazioni per trimestre. Ad esempio, può essere usata se si desidera visualizzare le vendite totali dei prodotti in base al trimestre.

Questa funzione può essere utilizzata nello script di caricamento per creare un campo in una tabella del Calendario principale. In alternativa, può essere utilizzata direttamente in un grafico come dimensione calcolata.

In questi esempi viene utilizzato il formato della data (MM/GG/AAAA). Il formato della data viene specificato nell'istruzione `SET DateFormat` nella parte superiore dello script di caricamento dei dati. Modificare il formato negli esempi in base alle proprie necessità.

Esempi di funzioni

| Esempio | Risultato |
| --- | --- |
| `quartername('10/29/2013')` | Restituisce Oct-Dec 2013. |
| `quartername('10/29/2013', -1)` | Restituisce Jul-Sep 2013. |
| `quartername('10/29/2013', 0, 3)` | Restituisce Sep-Nov 2013. |

## Impostazioni locali

Se non diversamente specificato, gli esempi di questo argomento utilizzano il seguente formato di data: MM/DD/YYYY. 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 applicazioni e script](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

Le impostazioni regionali predefinite nelle applicazioni 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 applicazioni, è possibile impostare la regione predefinita per le applicazioni che si creano. Per ulteriori informazioni, vedere [Regolazione delle impostazioni internazionali preferite per la creazione di app e script in Qlik Cloud Analytics](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Esempio 1 – data senza alcun argomento aggiuntivo

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 per il 2022, caricato in una tabella denominata '`Transactions`'.

* Il campo della data fornito nel formato della variabile di sistema `DateFormat` (MM/GG/AAAA).

* La creazione di un campo, `transaction_quarter`, che restituisce il trimestre in cui sono avvenute le transazioni.

Aggiungere qui altro testo, se necessario, con elenchi, ecc.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Risultati

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

* `date`

* `transaction_quarter`

Tabella dei risultati

| date | trimestre della transazione |
| --- | --- |
| 1/7/2022 | gen-mar 2022 |
| 1/19/2022 | gen-mar 2022 |
| 2/5/2022 | gen-mar 2022 |
| 2/28/2022 | gen-mar 2022 |
| 3/16/2022 | gen-mar 2022 |
| 4/1/2022 | apr-giu 2022 |
| 5/7/2022 | apr-giu 2022 |
| 5/16/2022 | apr-giu 2022 |
| 6/15/2022 | apr-giu 2022 |
| 6/26/2022 | apr-giu 2022 |
| 7/9/2022 | lug-set 2022 |
| 7/22/2022 | lug-set 2022 |
| 7/23/2022 | lug-set 2022 |
| 7/27/2022 | lug-set 2022 |
| 8/2/2022 | lug-set 2022 |
| 8/8/2022 | lug-set 2022 |
| 8/19/2022 | lug-set 2022 |
| 9/26/2022 | lug-set 2022 |
| 10/14/2022 | ott-dic 2022 |
| 10/29/2022 | ott-dic 2022 |

Il campo '`transaction_quarter`' viene creato nell'istruzione di caricamento precedente mediante l'uso della funzione `quartername()` e trasferendo il campo data come argomento della funzione.

La funzione `quartername()` identifica inizialmente il trimestre in cui rientra il valore della data. Restituisce quindi un valore che mostra i mesi iniziali e finali di questo trimestre e dell'anno.

Schema della funzione `quartername()`, esempio senza argomenti aggiuntivi

Schema della funzione `quartername()`, esempio senza argomenti aggiuntivi

Schema della funzione `quartername()`quartername(), esempio senza argomenti aggiuntivi ![Schema che mostra come la funzione quartername determini l'intervallo di mesi del trimestre in cui avviene una transazione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

La transazione 8203 è avvenuta l'8 agosto 2022. La funzione `quartername()` identifica che la transazione è avvenuta nel terzo trimestre e quindi restituisce luglio-settembre 2022. I mesi vengono visualizzati nello stesso formato della variabile di sistema `MonthNames`.

## Esempio 2 - data con argomento period\_no

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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:

* Vengono utilizzati lo stesso set di dati e lo stesso scenario del primo esempio.

* La creazione di un campo, `previous_quarter`, che restituisce il trimestre precedente in cui sono state effettuate le transazioni.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,-1) as previous_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Risultati

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

* `date`

* `previous_quarter`

Tabella dei risultati

| date | trimestre precedente |
| --- | --- |
| 1/7/2022 | ott-dic 2021 |
| 1/19/2022 | ott-dic 2021 |
| 2/5/2022 | ott-dic 2021 |
| 2/28/2022 | ott-dic 2021 |
| 3/16/2022 | ott-dic 2021 |
| 4/1/2022 | gen-mar 2022 |
| 5/7/2022 | gen-mar 2022 |
| 5/16/2022 | gen-mar 2022 |
| 6/15/2022 | gen-mar 2022 |
| 6/26/2022 | gen-mar 2022 |
| 7/9/2022 | apr-giu 2022 |
| 7/22/2022 | apr-giu 2022 |
| 7/23/2022 | apr-giu 2022 |
| 7/27/2022 | apr-giu 2022 |
| 8/2/2022 | apr-giu 2022 |
| 8/8/2022 | apr-giu 2022 |
| 8/19/2022 | apr-giu 2022 |
| 9/26/2022 | apr-giu 2022 |
| 10/14/2022 | lug-set 2022 |
| 10/29/2022 | lug-set 2022 |

In questo caso, poiché il valore `period_no` di -1 è stato utilizzato come argomento offset nella funzione `quartername()`, la funzione per prima cosa identifica le transazioni avvenute nel terzo trimestre. Passa quindi al trimestre precedente e restituisce un valore che mostra i mesi iniziali e finali di questo trimestre e dell'anno.

Schema della funzione `quartername()`, esempio di period\_no

Schema della funzione `quartername()`, esempio di period\_no

Schema della funzione `quartername()`quartername(), esempio di period\_no ![Schema che mostra come la funzione quartername determini l'intervallo di mesi del trimestre in cui avviene una transazione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

La transazione 8203 è avvenuta l'8 agosto. La funzione `quartername()` identifica che il trimestre precedente la transazione era compreso tra il 1° aprile e il 30 giugno. Pertanto, restituisce Apr-Giu 2022.

## Esempio 3 – data con argomento first\_week\_day

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

#### Script di caricamento e risultati

Panoramica

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

Lo script di caricamento contiene lo stesso set di dati e lo stesso scenario del primo esempio. Tuttavia, in questo esempio, dobbiamo impostare il 1° marzo come inizio dell'anno finanziario.

Script di caricamento

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,0,3) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Risultati

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

* `date`

* `transaction_quarter`

Tabella dei risultati

| date | trimestre della transazione |
| --- | --- |
| 1/7/2022 | Dic-Feb 2021 |
| 1/19/2022 | Dic-Feb 2021 |
| 2/5/2022 | Dic-Feb 2021 |
| 2/28/2022 | Dic-Feb 2021 |
| 3/16/2022 | Mar-Mag 2022 |
| 4/1/2022 | Mar-Mag 2022 |
| 5/7/2022 | Mar-Mag 2022 |
| 5/16/2022 | Mar-Mag 2022 |
| 6/15/2022 | Giu-Ago 2022 |
| 6/26/2022 | Giu-Ago 2022 |
| 7/9/2022 | Giu-Ago 2022 |
| 7/22/2022 | Giu-Ago 2022 |
| 7/23/2022 | Giu-Ago 2022 |
| 7/27/2022 | Giu-Ago 2022 |
| 8/2/2022 | Giu-Ago 2022 |
| 8/8/2022 | Giu-Ago 2022 |
| 8/19/2022 | Giu-Ago 2022 |
| 9/26/2022 | Set-Nov 2022 |
| 10/14/2022 | Set-Nov 2022 |
| 10/29/2022 | Set-Nov 2022 |

In questo caso, poiché nella funzione `quartername()` viene utilizzato l'argomento `first_month_of_year` di 3, l'inizio dell'anno si sposta dal 1° gennaio al 1° marzo. Pertanto, i trimestri dell'anno sono separati in marzo-maggio, giugno-agosto, settembre-novembre e dicembre-febbraio.

Schema della funzione `quartername()`, esempio first\_week\_day

Schema della funzione `quartername()`, esempio first\_week\_day

Schema della funzione `quartername()`quartername(), esempio first\_week\_day ![Schema che mostra come la funzione quartername determini l'intervallo di mesi del trimestre in cui avviene una transazione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

La transazione 8203 è avvenuta l'8 agosto. La funzione `quartername()` identifica che la transazione è avvenuta nel secondo trimestre, tra l'inizio di giugno e la fine di agosto. Pertanto, restituisce Giu-Ago 2022.

## Esempio 4 - Esempio di oggetto grafico

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

#### Script di caricamento ed espressione del 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 e lo stesso scenario del primo esempio.

Tuttavia, in questo esempio, il set di dati invariato viene caricato nell'applicazione. Il calcolo che restituisce un timestamp per la fine del trimestre in cui sono avvenute le transazioni viene creato come misura in un oggetto grafico dell'applicazione.

Script di caricamento

```
Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Risultati

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

Creare la seguente misura:

=quartername(date)

Tabella dei risultati

| date | =nome\_trimestre(data) |
| --- | --- |
| 1/7/2022 | gen-mar 2022 |
| 1/19/2022 | gen-mar 2022 |
| 2/5/2022 | gen-mar 2022 |
| 2/28/2022 | gen-mar 2022 |
| 3/16/2022 | gen-mar 2022 |
| 4/1/2022 | apr-giu 2022 |
| 5/7/2022 | apr-giu 2022 |
| 5/16/2022 | apr-giu 2022 |
| 6/15/2022 | apr-giu 2022 |
| 6/26/2022 | apr-giu 2022 |
| 7/9/2022 | lug-set 2022 |
| 7/22/2022 | lug-set 2022 |
| 7/23/2022 | lug-set 2022 |
| 7/27/2022 | lug-set 2022 |
| 8/2/2022 | lug-set 2022 |
| 8/8/2022 | lug-set 2022 |
| 8/19/2022 | lug-set 2022 |
| 9/26/2022 | lug-set 2022 |
| 10/14/2022 | ott-dic 2022 |
| 10/29/2022 | ott-dic 2022 |

La misura transaction\_quarter viene creata nell'oggetto grafico mediante l'utilizzo della funzione quartername() e trasferendo il campo date come argomento della funzione.

La funzione quartername() identifica inizialmente il trimestre in cui rientra il valore della data. Restituisce quindi un valore che mostra i mesi iniziali e finali di questo trimestre e dell'anno.

Schema della funzione quartername(), esempio di oggetto grafico

Schema della funzione quartername(), esempio di oggetto grafico

Schema della funzione quartername()quartername(), esempio di oggetto grafico ![Schema che mostra come la funzione quartername determini l'intervallo di mesi del trimestre in cui avviene una transazione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

La transazione 8203 è avvenuta l'8 agosto 2022. La funzione quartername() identifica che la transazione è avvenuta nel terzo trimestre e quindi restituisce luglio-settembre 2022. I mesi vengono visualizzati nello stesso formato della variabile di sistema MonthNames.

## Esempio 5 – Scenario

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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:

* Un set di dati contenente un insieme di transazioni per il 2022, caricato in una tabella denominata Transactions.

* Il campo della data fornito nel formato della variabile di sistema DateFormat (MM/GG/AAAA).

L'utente finale desidera un oggetto grafico che presenti le vendite totali per trimestre per le transazioni. Questo può essere ottenuto anche quando la dimensione non è disponibile nel modello dati, utilizzando la funzione quartername() come dimensione calcolata nel grafico.

Script di caricamento

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

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/7/2022',17.17
8189,'1/19/2022',37.23
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

Risultati

Procedere come indicato di seguito:

1. Caricare i dati e aprire un foglio. Creare una nuova tabella.

2. Creare una dimensione calcolata utilizzando la seguente espressione:

   =quartername(date)

3. Quindi, calcolare le vendite totali utilizzando la seguente misura di aggregazione:

   =sum(amount)

4. Impostare la Formattazione numero della misura su Denaro.

Tabella dei risultati

| =nome\_trimestre(data) | sum(amount) |
| --- | --- |
| lug-set 2022 | USD 446.31 |
| apr-giu 2022 | 351.48 $ |
| gen-mar 2022 | 253.89 $ |
| ott-dic 2022 | 163.91 $ |