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

[](https://help.qlik.com/en-US/cloud-services/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

| date | 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/cloud-services/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/cloud-services/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

| date | 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/cloud-services/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/cloud-services/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

| date | =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/cloud-services/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`.