Deze functie retourneert de maand (opgemaakt volgens de scriptvariabele MonthNames) en het jaar met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de maand.
Syntaxis:
MonthName(date[, period_no])
Retourgegevenstypen: dual
Diagram van functie monthname
| Argument | Beschrijving |
|---|---|
| date | De te evalueren datum of tijdstempel. |
| period_no | period_no is een geheel getal dat, indien het 0 is of wordt weggelaten, de maand aangeeft die date bevat. Negatieve waarden in period_no geven voorafgaande maanden aan en positieve waarden geven volgende maanden aan. |
| Voorbeeld | Resultaat |
|---|---|
| monthname('10/19/2013') | Retourneert Oct 2013 |
| monthname('10/19/2013', -1) | Retourneert Sep 2013 |
Landinstellingen
Tenzij anders aangegeven, wordt in de voorbeelden in dit onderwerp de volgende datumindeling gebruikt: MM/DD/JJJJ. De datumopmaak wordt opgegeven in de opdracht SET DateFormat in uw script voor het laden van gegevens. De standaard datumindeling is mogelijk anders op uw systeem vanwege landinstellingen en andere factoren. U kunt de indelingen in de voorbeelden wijzigen zodat deze aansluiten op uw behoeften. Of u kunt de indelingen in uw load-script wijzigen zodat ze overeenkomen met deze voorbeelden. Ga voor meer informatie naar Regionale instellingen voor apps en scripts aanpassen.
Standaard landinstellingen van de app zijn gebaseerd op het gebruikersprofiel. Deze landinstellingen voor indelingen zijn niet gerelateerd aan de taal die wordt weergegeven in de gebruikersinterface van Qlik Cloud. Qlik Cloud wordt weergegeven in dezelfde taal als de browser die u gebruikt.
Als u een app-ontwikkelaar bent, kunt u de standaardregio instellen voor apps die u maakt. Ga voor meer informatie naar Instellen van uw voorkeur voor regionale instellingen voor het maken van apps en scripts in Qlik Cloud Analyse.
Voorbeeld 1 – Basisvoorbeeld
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
-
Een gegevensverzameling met een set transacties voor 2022 die wordt geladen in de tabel Transactions.
-
Het datumveld opgegeven in de DateFormat-systeemvariabele (MM/DD/YYYY) indeling.
-
Het maken van een veld, transaction_month, dat de maand retourneert waarin de transacties plaatsvonden.
Load-script
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
];Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:
-
date
-
transaction_month
| date | transaction_month |
|---|---|
| 1/7/2022 | januari 2022 |
| 1/19/2022 | januari 2022 |
| 2/5/2022 | februari 2022 |
| 2/28/2022 | februari 2022 |
| 3/16/2022 | maart 2022 |
| 4/1/2022 | april 2022 |
| 5/7/2022 | mei 2022 |
| 5/16/2022 | mei 2022 |
| 6/15/2022 | juni 2022 |
| 6/26/2022 | juni 2022 |
| 7/9/2022 | juli 2022 |
| 7/22/2022 | juli 2022 |
| 7/23/2022 | juli 2022 |
| 7/27/2022 | juli 2022 |
| 8/2/2022 | augustus 2022 |
| 8/8/2022 | augustus 2022 |
| 8/19/2022 | augustus 2022 |
| 9/26/2022 | september 2022 |
| 10/14/2022 | oktober 2022 |
| 10/29/2022 | oktober 2022 |
Het transaction_month-veld wordt gemaakt in de voorafgaande load-instructie met behulp van de monthname()-functie en geeft het date-veld door als het argument van de functie.
Diagram van functie monthname, basisvoorbeeld
De functie monthname() identificeert dat transactie 8192 plaatsvond in maart 2022 en retourneert deze waarde met behulp van de systeemvariabele MonthNames.
Voorbeeld 2 – period_no
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
-
Dezelfde inline gegevensset en het scenario uit het eerste voorbeeld.
-
Het maken van een veld, transaction_previous_month, dat de tijdstempel voor het einde van de maand retourneert voordat de transactie plaatsvond.
Load-script
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
];Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:
-
date
-
transaction_previous_month
| date | transaction_previous_month |
|---|---|
| 1/7/2022 | december 2021 |
| 1/19/2022 | december 2021 |
| 2/5/2022 | januari 2022 |
| 2/28/2022 | januari 2022 |
| 3/16/2022 | februari 2022 |
| 4/1/2022 | maart 2022 |
| 5/7/2022 | april 2022 |
| 5/16/2022 | april 2022 |
| 6/15/2022 | mei 2022 |
| 6/26/2022 | mei 2022 |
| 7/9/2022 | juni 2022 |
| 7/22/2022 | juni 2022 |
| 7/23/2022 | juni 2022 |
| 7/27/2022 | juni 2022 |
| 8/2/2022 | juli 2022 |
| 8/8/2022 | juli 2022 |
| 8/19/2022 | juli 2022 |
| 9/26/2022 | augustus 2022 |
| 10/14/2022 | september 2022 |
| 10/29/2022 | september 2022 |
In dit geval, omdat een period_no van -1 werd gebruikt als het offset-argument in de monthname()-functie, identificeert de functie eerst de maand waarin de transacties plaatsvinden. Het verschuift dan naar een maand eerder en retourneert de naam van de maand en het jaar.
Diagram van functie monthname, voorbeeld period_no
Transactie 8192 vond plaats op 16 maart. De functie monthname() identificeert dat de maand voordat de transactie plaatsvond februari was en retourneert de maand, in de systeemvariabele-indeling MonthNames, samen met het jaar 2022.
Voorbeeld 3 – diagramobjectvoorbeeld
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat dezelfde inline gegevensset en scenario als het eerste voorbeeld. In dit voorbeeld wordt de ongewijzigde gegevensset echter in de applicatie geladen. De berekening die een tijdstempel retourneert voor het einde van de maand waarin de transacties plaatsvonden is gemaakt als meting in een diagramobject van de toepassing.
Load-script
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
];Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie:date.
Maak de volgende meting:
=monthname(date)
| date | =monthname(date) |
|---|---|
| 1/7/2022 | januari 2022 |
| 1/19/2022 | januari 2022 |
| 2/5/2022 | februari 2022 |
| 2/28/2022 | februari 2022 |
| 3/16/2022 | maart 2022 |
| 4/1/2022 | april 2022 |
| 5/7/2022 | mei 2022 |
| 5/16/2022 | mei 2022 |
| 6/15/2022 | juni 2022 |
| 6/26/2022 | juni 2022 |
| 7/9/2022 | juli 2022 |
| 7/22/2022 | juli 2022 |
| 7/23/2022 | juli 2022 |
| 7/27/2022 | juli 2022 |
| 8/2/2022 | augustus 2022 |
| 8/8/2022 | augustus 2022 |
| 8/19/2022 | augustus 2022 |
| 9/26/2022 | september 2022 |
| 10/14/2022 | oktober 2022 |
| 10/29/2022 | oktober 2022 |
De meting month_name wordt gemaakt in het diagramobject met behulp van de functie monthname() en geeft het veld date door als het argument van de functie.
Diagram van functie monthname, diagramobjectvoorbeeld
De functie monthname() identificeert dat transactie 8192 plaatsvond in maart 2022 en retourneert deze waarde met behulp van de systeemvariabele MonthNames.