# 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: dubbele waarde

Diagram van de `quartername()`-functie

Diagram van de `quartername()`-functie

Diagram van de `quartername()`quartername()-functie ![Voorbeelddiagram laat zien hoe de quartername-functie een invoerdatum omzet in een reeks maanden die in het kwartaal zitten waarin de datum valt.](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

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/YYYY. 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.

Standaard landinstellingen in toepassingen zijn gebaseerd op de regionale systeeminstellingen van de computer of server waarop Qlik Sense is geïnstalleerd. Als de Qlik Sense-server die u gebruikt is ingesteld op Zweden, gebruikt de editor voor laden van gegevens de Zweedse landinstellingen voor datums, tijd en valuta. Deze landinstellingen voor indelingen zijn niet gerelateerd aan de taal die wordt weergegeven in de Qlik Sense gebruikersinterface. Qlik Sense wordt weergegeven in dezelfde taal als de browser die u gebruikt.

## Voorbeeld 1 – Datum zonder aanvullende argumenten

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

#### Load-script en resultaten

Overzicht

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

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.

Diagram van `quartername()`-functie, voorbeeld zonder aanvullende argumenten

Diagram van `quartername()`-functie, voorbeeld zonder aanvullende argumenten

Diagram van `quartername()`quartername()-functie, voorbeeld zonder aanvullende argumenten ![Het diagram laat zien hoe de quartername-functie de reeks maanden van het kwartaal bepaalt waarin een transactie plaatsvindt.](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

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

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

#### Load-script en resultaten

Overzicht

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

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.

Diagram van `quartername()`-functie, voorbeeld period\_no

Diagram van `quartername()`-functie, voorbeeld period\_no

Diagram van `quartername()`quartername()-functie, voorbeeld period\_no ![Het diagram laat zien hoe de quartername-functie de reeks maanden van het kwartaal bepaalt waarin een transactie plaatsvindt.](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

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

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

#### Load-script en resultaten

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.

Diagram van de `quartername()`-functie, voorbeeld met first\_week\_day

Diagram van de `quartername()`-functie, voorbeeld met first\_week\_day

Diagram van de `quartername()`quartername()-functie, voorbeeld met first\_week\_day ![Het diagram laat zien hoe de quartername-functie de reeks maanden van het kwartaal bepaalt waarin een transactie plaatsvindt.](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

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

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

#### Load-script en diagramuitdrukking

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.

Diagram van quartername()-functie, diagramobjectvoorbeeld

Diagram van quartername()-functie, diagramobjectvoorbeeld

Diagram van quartername()quartername()-functie, diagramobjectvoorbeeld ![Het diagram laat zien hoe de quartername-functie de reeks maanden van het kwartaal bepaalt waarin een transactie plaatsvindt.](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

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 5 – Scenario

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

#### Load-script en diagramuitdrukking

Overzicht

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

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:

1. Laad de gegevens en open een werkblad. Maak een nieuwe tabel.

2. Maak een berekende dimensie met behulp van de volgende uitdrukking:

   =quartername(date)

3. Bereken vervolgens de totale verkoop met de volgende aggregatiemeting:

   =sum(amount)

4. 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 |