quartername - script- en diagramfunctie

Deze functie retourneert de maanden van het kwartaal (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 het kwartaal.

Syntaxis:

QuarterName(date[, period_no[, first_month_of_year]])

Retourgegevenstypen: dual

Voorbeelddiagram laat zien hoe de quartername-functie een invoerdatum omzet in een reeks maanden die in het kwartaal zitten waarin de datum valt. — Diagram van de quartername()-functie

De quartername()-functie bepaalt welk kwartaal de datum in valt. Hij retourneert vervolgens een waarde die de begin- en eindmaanden van het kwartaal en van het jaar laten zien. De achterliggende numerieke waarde van dit resultaat is de eerste milliseconde van het kwartaal.

Argumenten
Argument	Beschrijving
date	De te evalueren datum of tijdstempel.
period_no	period_no is een geheel getal, waarbij de waarde 0 het kwartaal aangeeft dat date bevat. Negatieve waarden in period_no geven voorafgaande kwartalen aan en positieve waarden geven volgende kwartalen aan.
first_month_of_year	Als u wilt werken met (boek)jaren die niet in januari beginnen, geeft u een waarde op tussen 2 en 12 in first_month_of_year.

Wanneer gebruiken

De quartername()-functie is handig als u aggregaties per kwartaal wilt vergelijken. Bijvoorbeeld als u de totale verkoop van producten per kwartaal wilt zien.

Deze functie kan in het load-script worden gebruikt om een veld in een masterkalendertabel te maken. Hij zou ook rechtstreeks in een diagram kunnen worden gebruikt als een berekende dimensie.

Deze voorbeelden gebruiken de datumopmaak MM/DD/YYYY. De datumopmaak wordt opgegeven in de opdracht SET DateFormat boven aan uw script voor het laden van gegevens. Wijzig de opmaak in de voorbeelden zodat deze in uw behoeften voorziet.

Voorbeelden van functies
Voorbeeld	Resultaat
quartername('10/29/2013')	Retourneert Oct-Dec 2013.
quartername('10/29/2013', -1)	Retourneert Jul-Sep 2013.
quartername('10/29/2013', 0, 3)	Retourneert Sep-Nov 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 – Datum zonder aanvullende argumenten

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_quarter, dat het kwartaal retourneert waarin de transacties plaatsvonden.

Voeg hier uw andere tekst toe, indien nodig, met lijsten enz.

Load-script

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
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

date
transaction_quarter

Resultatentabel
date	transaction_quarter
1/7/2022	jan-mrt 2022
1/19/2022	jan-mrt 2022
2/5/2022	jan-mrt 2022
2/28/2022	jan-mrt 2022
3/16/2022	jan-mrt 2022
4/1/2022	april-jun 2022
5/7/2022	april-jun 2022
5/16/2022	april-jun 2022
6/15/2022	april-jun 2022
6/26/2022	april-jun 2022
7/9/2022	juli-sept 2022
7/22/2022	juli-sept 2022
7/23/2022	juli-sept 2022
7/27/2022	juli-sept 2022
8/2/2022	juli-sept 2022
8/8/2022	juli-sept 2022
8/19/2022	juli-sept 2022
9/26/2022	juli-sept 2022
10/14/2022	okt-dec 2022
10/29/2022	okt-dec 2022

Het veld 'transaction_quarter' wordt gemaakt in de voorafgaande load-instructie met behulp van de functie quartername() en geeft het datumveld door als het argument van de functie.

De quartername()-functie identificeert eerst het kwartaal waarin de datumwaarde valt. Hij retourneert vervolgens een waarde die de begin- en eindmaanden van het kwartaal en van het jaar laten zien.

Het diagram laat zien hoe de quartername-functie de reeks maanden van het kwartaal bepaalt waarin een transactie plaatsvindt. — Diagram van quartername()-functie, voorbeeld zonder aanvullende argumenten

Transactie 8203 vond plaats op 8 augustus 2022. De quartername()-functie identificeert dat de transactie plaatsvond in het derde kwartaal en retourneert daarom jul-sep 2022. De maanden worden weergegeven met dezelfde notatie als de MonthNames-systeemvariabele.

Voorbeeld 2 – Datum met period_no argument

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.

Het load-script bevat:

Dezelfde gegevensset en het scenario uit het eerste voorbeeld.
Het veld previous_quarter wordt gemaakt en retourneert het kwartaal dat voor het kwartaal valt 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
        *,
        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
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

date
previous_quarter

Resultatentabel
date	previous_quarter
1/7/2022	okt-dec 2021
1/19/2022	okt-dec 2021
2/5/2022	okt-dec 2021
2/28/2022	okt-dec 2021
3/16/2022	okt-dec 2021
4/1/2022	jan-mrt 2022
5/7/2022	jan-mrt 2022
5/16/2022	jan-mrt 2022
6/15/2022	jan-mrt 2022
6/26/2022	jan-mrt 2022
7/9/2022	april-jun 2022
7/22/2022	april-jun 2022
7/23/2022	april-jun 2022
7/27/2022	april-jun 2022
8/2/2022	april-jun 2022
8/8/2022	april-jun 2022
8/19/2022	april-jun 2022
9/26/2022	april-jun 2022
10/14/2022	juli-sept 2022
10/29/2022	juli-sept 2022

In dit geval, omdat een period_no van -1 is gebruikt als het offset-argument in de quartername()-functie, identificeert de functie eerst dat de transacties in het derde kwartaal hebben plaatsgevonden. Vervolgens wordt dit naar één kwartaal eerder verschoven en wordt een waarde geretourneerd die de begin- en eindmaanden van het kwartaal en van het jaar laten zien.

Transactie 8203 vond plaats op 8 augustus. De quartername()-functie identificeert dat het kwartaal vóór het kwartaal waarin de transactie plaatsvond tussen 1 april en 30 juni viel. Daarom wordt apr-jun 2022 geretourneerd.

Voorbeeld 3 – Datum met first_week_day-argument

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.

Het load-script bevat dezelfde gegevensset en scenario als het eerste voorbeeld. In dit voorbeeld moeten we echter 1 maart instellen als het begin van het boekjaar.

Load-script

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
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

date
transaction_quarter

Resultatentabel
date	transaction_quarter
1/7/2022	Dec-feb 2021
1/19/2022	Dec-feb 2021
2/5/2022	Dec-feb 2021
2/28/2022	Dec-feb 2021
3/16/2022	Maa-mei 2022
4/1/2022	Maa-mei 2022
5/7/2022	Maa-mei 2022
5/16/2022	Maa-mei 2022
6/15/2022	Jun-aug 2022
6/26/2022	Jun-aug 2022
7/9/2022	Jun-aug 2022
7/22/2022	Jun-aug 2022
7/23/2022	Jun-aug 2022
7/27/2022	Jun-aug 2022
8/2/2022	Jun-aug 2022
8/8/2022	Jun-aug 2022
8/19/2022	Jun-aug 2022
9/26/2022	Sep-nov 2022
10/14/2022	Sep-nov 2022
10/29/2022	Sep-nov 2022

In deze instantie wordt het begin van het jaar van 1 januari naar 1 maart verplaatst omdat het first_month_of_year-argument van 3 is gebruikt in de quartername()-functie. Daarom worden de kwartalen van het jaar verdeeld in maart-mei, juni-augustus, september-november en december-februari.

Transactie 8203 vond plaats op 8 augustus. De quartername()-functie identificeert dat de transactie plaatsvond in het tweede kwartaal, tussen het begin van juni en het eind van augustus. Daarom wordt jun-aug 2022 geretourneerd.

Voorbeeld 4 – 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 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 eind van het kwartaal waarin de transacties plaatsvonden is gemaakt als meting in een diagramobject van de toepassing.

Load-script

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
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie: date.

Maak de volgende meting:

=quartername(date)

Resultatentabel
date	=quartername(date)
1/7/2022	jan-mrt 2022
1/19/2022	jan-mrt 2022
2/5/2022	jan-mrt 2022
2/28/2022	jan-mrt 2022
3/16/2022	jan-mrt 2022
4/1/2022	april-jun 2022
5/7/2022	april-jun 2022
5/16/2022	april-jun 2022
6/15/2022	april-jun 2022
6/26/2022	april-jun 2022
7/9/2022	juli-sept 2022
7/22/2022	juli-sept 2022
7/23/2022	juli-sept 2022
7/27/2022	juli-sept 2022
8/2/2022	juli-sept 2022
8/8/2022	juli-sept 2022
8/19/2022	juli-sept 2022
9/26/2022	juli-sept 2022
10/14/2022	okt-dec 2022
10/29/2022	okt-dec 2022

De meting transaction_quarter wordt gemaakt in het diagramobject met behulp van de functie quartername() en geeft het veld date door als het argument van de functie.

De quartername()-functie identificeert eerst het kwartaal waarin de datumwaarde valt. Hij retourneert vervolgens een waarde die de begin- en eindmaanden van het kwartaal en van het jaar laten zien.

Voorbeeld 5 – Scenario

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.

Het load-script bevat:

Een gegevensset met een set transacties voor 2022 die wordt geladen in een tabel met de naam Transactions.
Het datumveld opgegeven in de DateFormat-systeemvariabele (MM/DD/YYYY) indeling.

De eindgebruiker wil graag een diagramobject dat de totale omzet per kwartaal voor de transacties weergeeft. Dit kan zelfs worden bereikt als deze dimensie niet beschikbaar is in het gegevensmodel, door de functie quartername() te gebruiken als een berekende dimensie in het diagram.

Load-script

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
];

Resultaten

Doe het volgende:

Laad de gegevens en open een werkblad. Maak een nieuwe tabel.
Maak een berekende dimensie met behulp van de volgende uitdrukking:

=quartername(date)
Bereken vervolgens de totale verkoop met de volgende aggregatiemeting:

=sum(amount)
Stel de Getalnotatie van de meting in op Geld.

Resultatentabel
=quartername(date)	=sum(amount)
juli-sept 2022	$446.31
april-jun 2022	$351.48
jan-mrt 2022	$253.89
okt-dec 2022	$163.91

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback