# monthname - Funzione per script e grafici

Questa funzione restituisce un valore di visualizzazione che mostra il mese (formattato in base alla variabile di script MonthNames) e l'anno il cui valore numerico sottostante corrisponde a un indicatore temporale recante il primo millisecondo del primo giorno del mese.

Sintassi:

MonthName(date[, period\_no])

Tipo di dati restituiti: duale

Schema della funzione monthname

Schema della funzione monthname

Schema della funzione monthname ![Diagramma di esempio della funzione monthname, che mostra come la funzione restituisce il risultato combinato di un mese e di un anno quando viene assegnata una data di input specifica.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-general.png)

Argomenti

| Argomento | Descrizione |
| --- | --- |
| date | La data o la data e ora da valutare. |
| period\_no | period\_no è un numero intero che, se corrisponde a 0 o viene omesso, indica il mese contenente date. I valori negativi di period\_no indicano i mesi precedenti, mentre i valori positivi indicano i mesi successivi. |

Esempi di funzioni

| Esempio | Risultato |
| --- | --- |
| `monthname('10/19/2013')` | Restituisce Oct 2013 |
| `monthname('10/19/2013', -1)` | Restituisce Sep 2013 |

## 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 – Esempio di base

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.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_month`, che restituisce il mese 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
        *,
        monthname(date) as transaction_month
        ;
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_month`

Tabella dei risultati

| data | mese\_transazione |
| --- | --- |
| 1/7/2022 | Gen 2022 |
| 1/19/2022 | Gen 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Apr 2022 |
| 5/7/2022 | Mag 2022 |
| 5/16/2022 | Mag 2022 |
| 6/15/2022 | Giu 2022 |
| 6/26/2022 | Giu 2022 |
| 7/9/2022 | Lug 2022 |
| 7/22/2022 | Lug 2022 |
| 7/23/2022 | Lug 2022 |
| 7/27/2022 | Lug 2022 |
| 8/2/2022 | Ago 2022 |
| 8/8/2022 | Ago 2022 |
| 8/19/2022 | Ago 2022 |
| 9/26/2022 | Set 2022 |
| 10/14/2022 | Ott 2022 |
| 10/29/2022 | Ott 2022 |

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

Schema della funzione monthname, esempio di base

Schema della funzione monthname, esempio di base

Schema della funzione monthname, esempio di base![Diagramma che mostra i risultati dell'utilizzo della funzione monthname per determinare il mese in cui è avvenuta una transazione.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-basic-example.png)

La funzione `monthname()` identifica la transazione 8192 avvenuta nel marzo 2022 e restituisce questo valore utilizzando la variabile di sistema `MonthNames`.

## Esempio 2 – period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.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 inline e lo stesso scenario del primo esempio.

* La creazione di un campo, `transaction_previous_month`, che restituisce data e ora per la fine del mese prima che fosse effettuata la transazione.

Script di caricamento

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

Transactions:
    Load
        *,
        monthname(date,-1) as transaction_previous_month
        ;
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_previous_month`

Tabella dei risultati

| data | transazione\_mese\_precedente |
| --- | --- |
| 1/7/2022 | Dic 2021 |
| 1/19/2022 | Dic 2021 |
| 2/5/2022 | Gen 2022 |
| 2/28/2022 | Gen 2022 |
| 3/16/2022 | Feb 2022 |
| 4/1/2022 | Mar 2022 |
| 5/7/2022 | Apr 2022 |
| 5/16/2022 | Apr 2022 |
| 6/15/2022 | Mag 2022 |
| 6/26/2022 | Mag 2022 |
| 7/9/2022 | Giu 2022 |
| 7/22/2022 | Giu 2022 |
| 7/23/2022 | Giu 2022 |
| 7/27/2022 | Giu 2022 |
| 8/2/2022 | Lug 2022 |
| 8/8/2022 | Lug 2022 |
| 8/19/2022 | Lug 2022 |
| 9/26/2022 | Ago 2022 |
| 10/14/2022 | Set 2022 |
| 10/29/2022 | Set 2022 |

In questo caso, poiché il valore `period_no` di -1 è stato utilizzato come argomento offset nella funzione `monthname()`, la funzione per prima cosa identifica il mese in cui avvengono le transazioni. Quindi, passa a al mese anteriore e restituisce il nome del mese e l'anno.

Schema della funzione monthname, esempio di period\_no

Schema della funzione monthname, esempio di period\_no

Schema della funzione monthname, esempio di period\_no![Diagramma che mostra i risultati dell'utilizzo della funzione monthname per determinare il mese in cui è avvenuta una transazione.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-period-no.png)

La transazione 8192 è avvenuta il 16 marzo. La funzione `monthname()` identifica che il mese precedente all'esecuzione della transazione è febbraio, quindi restituisce il mese nel formato della variabile di sistema `MonthNames`, insieme all'anno 2022.

## Esempio 3 - Esempio di oggetto grafico

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

Lo script di caricamento utilizza lo stesso set di dati inline e lo stesso scenario del primo esempio. Tuttavia, in questo esempio, il set di dati invariato viene caricato nell'applicazione. Il calcolo che restituisce data e ora per la fine del mese in cui sono avvenute le transazioni viene creato come misura in un oggetto grafico dell'applicazione.

Script di caricamento

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

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

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

Creare la seguente misura:

`=monthname(date)`

Tabella dei risultati

| data | =monthname(date) |
| --- | --- |
| 1/7/2022 | Gen 2022 |
| 1/19/2022 | Gen 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Apr 2022 |
| 5/7/2022 | Mag 2022 |
| 5/16/2022 | Mag 2022 |
| 6/15/2022 | Giu 2022 |
| 6/26/2022 | Giu 2022 |
| 7/9/2022 | Lug 2022 |
| 7/22/2022 | Lug 2022 |
| 7/23/2022 | Lug 2022 |
| 7/27/2022 | Lug 2022 |
| 8/2/2022 | Ago 2022 |
| 8/8/2022 | Ago 2022 |
| 8/19/2022 | Ago 2022 |
| 9/26/2022 | Set 2022 |
| 10/14/2022 | Ott 2022 |
| 10/29/2022 | Ott 2022 |

La misura `month_name` viene creata nell'oggetto grafico mediante l'utilizzo della funzione `monthname()` e trasferendo il campo `date` come argomento della funzione.

Schema della funzione monthname, esempio di oggetto grafico

Schema della funzione monthname, esempio di oggetto grafico

Schema della funzione monthname, esempio di oggetto grafico![Diagramma che mostra i risultati dell'utilizzo della funzione monthname per determinare il mese in cui è avvenuta una transazione.](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-chart-object.png)

La funzione `monthname()` identifica la transazione 8192 avvenuta nel marzo 2022 e restituisce questo valore utilizzando la variabile di sistema `MonthNames`.