# inquartertodate Script- en diagramfunctie

Deze functie retourneert True als timestamp binnen het gedeelte van het kwartaal ligt dat base\_date bevat tot en met de laatste milliseconde van base\_date.

Syntaxis:

InQuarterToDate (timestamp, base\_date, period\_no [, first\_month\_of\_year])

Retourgegevenstypen: Booleaanse waarde

Informatie

In Qlik Sense wordt de booleaanse waarde Waar vertegenwoordigd door -1 en de waarde Onwaar door 0.

Diagram van functie inquartertodate

Diagram van functie inquartertodate

Diagram van functie inquartertodate ![Voorbeelddiagram van het datumbereik waarbinnen de functie inquartertodate de waarde WAAR retourneert.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-general.png)

De functie `inquartertodate()` verdeelt het jaar in vier gelijke kwartalen tussen 1 januari en 31 december (of het door de gebruiker gedefinieerde begin van het jaar en de bijbehorende einddatum). Met de `base_date` zal de functie dan een bepaald kwartaal segmenteren, waarbij de `base_date` zowel welk kwartaal als de maximaal toegestane datum voor dat kwartaalsegment aangeeft. Ten slotte retourneert de functie een booleaans resultaat bij het vergelijken van de voorgeschreven datumwaarden met dat segment.

Argumenten

| Argument | Beschrijving |
| --- | --- |
| timestamp | De datum die u wilt vergelijken met base\_date. |
| base\_date | Datum op basis waarvan het kwartaal wordt geëvalueerd. |
| period\_no | Het kwartaal kan worden verschoven met period\_no. period\_no is een geheel getal, waarbij de waarde 0 het kwartaal aangeeft dat base\_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 gebruikt u inquartertodate

De functie `inquartertodate()` retourneert een booleaanse waarde. Dit type functie wordt doorgaans gebruikt als voorwaarde in een `if`-uitdrukking. De `inquartertodate()`-functie wordt gebruikt om een aggregatie of berekening te retourneren afhankelijk van of een geëvalueerde datum plaatsvond in het kwartaal tot en met de betreffende datum.

De functie `inquartertodate()` bijvoorbeeld kan worden gebruikt om alle materieel te identificeren die in een kwartaal tot en met een specifieke datum is geproduceerd.

Voorbeelden van functies

| Voorbeeld | Resultaat |
| --- | --- |
| `inquartertodate('01/25/2013', '03/25/2013', 0)` | Retourneert`TRUE`, aangezien de waarde van `timestamp`, 01/25/2013, binnen de periode ligt van drie maanden vanaf 01/01/2013 tot 03/25/2013, waarin de waarde van `base_date`, 03/25/2013, ligt. |
| `inquartertodate('04/26/2013', '03/25/2013', 0)` | Retourneert `FALSE`, aangezien 04/26/2013 buiten dezelfde periode als het vorige voorbeeld ligt. |
| `inquartertodate('02/25/2013', '06/09/2013', -1)` | Retourneert `TRUE`, aangezien de waarde van `period_no`, -1, de zoekperiode één periode van drie maanden terugschuift (een kwartaal van het jaar). Dit maakt de zoekperiode 01/01/2013 tot 03/09/2013. |
| `inquartertodate('03/25/2006', '04/15/2006', 0, 2)` | Retourneert `TRUE`, aangezien de waarde van `first_month_of_year` is ingesteld op 2, waardoor de zoekperiode 02/01/2006 tot 04/15/2006 wordt in plaats van 04/01/2006 tot 04/15/2006. |

## 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. Ga voor meer informatie naar [Regionale instellingen voor applicaties en scripts aanpassen](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

Standaard landinstellingen in applicaties 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 applicatie-ontwikkelaar bent, kunt u de standaardregio instellen voor applicaties 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](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Voorbeeld 1 – geen aanvullende argumenten

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.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 aanmaken van een veld, `  in_quarter_to_date `, dat bepaalt welke transacties hebben plaatsgevonden in het kwartaal tot 15 mei 2022.

Load-script

```
SET DateFormat='MM/DD/YYYY';
						
Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', 0) as in_quarter_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
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`

* `in_quarter_to_date`

Resultatentabel

| date | in\_quarter\_to\_date |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Het veld `in_quarter_to_date` wordt gemaakt in de vorige load-instructie met behulp van de functie `inquartertodate()`. Het eerste verstrekte argument geeft aan welk veld wordt geëvalueerd. Het tweede argument is een vastgestelde datum voor 15 mei, de `base_date` die aangeeft welk kwartaal moet worden gesegmenteerd en de eindgrens van dat segment definieert. Een `period_no` van 0 is het laatste argument, wat betekent dat de functie geen kwartalen voor of na het gesegmenteerde kwartaal vergelijkt.

Diagram van functie inquartertodate, geen aanvullende argumenten

Diagram van functie inquartertodate, geen aanvullende argumenten

Diagram van functie inquartertodate, geen aanvullende argumenten ![Diagram toont het datumbereik waarvoor de functie inquartertodate de waarde WAAR retourneert.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-no-additional-arguments.png)

Elke transactie die tussen 1 april en 15 mei plaatsvindt, retourneert een booleaans resultaat van `TRUE`. Transactiedatums van 16 mei en later zullen `FALSE` retourneren, net als alle transacties vóór 1 april.

## Voorbeeld 2 – period\_no

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.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 aanmaken van een veld, `previous_qtr_to_date`, dat bepaalt welke transacties een volledig kwartaal voor het einde van het kwartaalsegment op 15 mei 2022 hebben plaatsgevonden.

Load-script

```
SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', -1) as previous_qtr_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
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_qtr_to_date`

Resultatentabel

| date | previous\_qtr\_to\_date |
| --- | --- |
| 1/7/2022 | -1 |
| 1/19/2022 | -1 |
| 2/5/2022 | -1 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Een `period_no`-waarde van -1 geeft aan dat de functie `inquartertodate ()` het invoerkwartaalsegment vergelijkt met het voorgaande kwartaal. 15 mei valt in het tweede kwartaal van het jaar, dus het segment komt aanvankelijk overeen met tussen 1 april en 15 mei. De `period_no` compenseert dit segment vervolgens drie maanden eerder, waardoor de datumgrenzen van 1 januari tot 15 februari worden.

Diagram van functie inquartertodate, period\_no example

Diagram van functie inquartertodate, period\_no example

Diagram van functie inquartertodate, period\_no example ![Diagram toont het datumbereik waarvoor de functie inquartertodate de waarde WAAR retourneert.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-period-no.png)

Daarom zal elke transactie die plaatsvindt tussen 1 januari en 15 februari een booleaans resultaat van `TRUE` retourneren.

## Voorbeeld 3 – first\_month\_of\_year

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.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 aanmaken van een veld, `in_quarter_to_date`, dat bepaalt welke transacties hebben plaatsgevonden in hetzelfde kwartaal tot en met 15 mei 2022.

In dit voorbeeld stellen we maart in als de eerste maand van het fiscale jaar.

Load-script

```
SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', 0,3) as in_quarter_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
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`

* `in_quarter_to_date`

Resultatentabel

| date | in\_quarter\_to\_date |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | -1 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

Door 3 te gebruiken als het `first_month_of_year`-argument in de `inquartertodate()`-functie, begint de functie het jaar op 1 maart en verdeelt het jaar vervolgens in kwartalen. Daarom zijn de kwartaalsegmenten:

* maart tot mei

* juni tot augustus

* september tot november

* December tot februari

De `base_date` van 15 mei segmenteert vervolgens het kwartaal van maart tot mei door de eindgrens in te stellen op 15 mei.

Diagram van functie inquartertodate, first\_month\_of\_year example

Diagram van functie inquartertodate, first\_month\_of\_year example

Diagram van functie inquartertodate, first\_month\_of\_year example ![Diagram toont het datumbereik waarvoor de functie inquartertodate de waarde WAAR retourneert.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-first-mth-yr.png)

Daarom zal elke transactie die plaatsvindt tussen 1 maart en 15 mei een booleaans resultaat van `TRUE`retourneren, terwijl transacties met datums buiten deze grenzen een waarde van `FALSE` zullen retourneren.

## Voorbeeld 4 – diagramobjectvoorbeeld

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.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 bepaalt welke transacties plaatsvonden in hetzelfde kwartaal als 15 mei is gemaakt als een meting in het diagramobject.

Load-script

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
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:

=inquartertodate(date,'05/15/2022', 0)

Resultatentabel

| date | =inquartertodate(date,'05/15/2022', 0) |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

De meting in\_quarter\_to\_date wordt in een diagramobject gemaakt met behulp van de functie inquartertodate(). Het eerste argument is het datumveld dat wordt geëvalueerd. Het tweede argument is een vastgestelde datum voor 15 mei, de base\_date die aangeeft welk kwartaal moet worden gesegmenteerd en de eindgrens van dat segment definieert. Een period\_no van 0 is het laatste argument, wat betekent dat de functie geen kwartalen voor of na het gesegmenteerde kwartaal vergelijkt.

Diagram van functie inquartertodate, diagramobjectvoorbeeld

Diagram van functie inquartertodate, diagramobjectvoorbeeld

Diagram van functie inquartertodate, diagramobjectvoorbeeld ![Diagram toont het datumbereik waarvoor de functie inquartertodate de waarde WAAR retourneert.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-chart-object.png)

Elke transactie die tussen 1 april en 15 mei plaatsvindt, retourneert een booleaans resultaat van TRUE. Transacties op 16 mei en later zullen FALSE retourneren, net als alle transacties vóór 1 april.

## Voorbeeld 5 – Scenario

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.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 die wordt geladen in een tabel met de naam Products.

* Informatie over product-id, productiedatum en kostprijs.

Op 15 mei 2022 werd tijdens het productieproces een fout in de apparatuur vastgesteld en opgelost. Producten die tot die datum in dat kwartaal zijn geproduceerd, zullen defect zijn. De eindgebruiker wil graag een diagramobject dat op kwartaalnaam de status toont of het product 'defect' of 'foutloos' is en de kosten van producten die zijn geproduceerd in dat kwartaal.

Load-script

```
Products:
Load
*
Inline 
[
product_id,manufacture_date,cost_price
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
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. Maak een dimensie om de kwartaalnamen weer te geven:

   =quartername(manufacture\_date)

2. Maak vervolgens een dimensie om te identificeren welke van de producten defect zijn en welke foutloos zijn:

   =if(inquartertodate(manufacture\_date,makedate(2022,05,15),0),'Defective','Faultless')

3. Maak een meting om de cost\_price van de producten op te tellen:

   =sum(cost\_price)

4. Stel de Getalnotatie van de meting in op Geld.

Resultatentabel

| quartername(manufacture\_date) | if(inquartertodate(manufacture\_date,makedate(2022,05,15),0),'Defective','Faultless') | Sum(cost\_price) |
| --- | --- | --- |
| jan-mrt 2022 | Foutloos | $253.89 |
| april-jun 2022 | Foutloos | $229.03 |
| april-jun 2022 | Defect | $122.45 |
| juli-sept 2022 | Foutloos | $446.31 |
| okt-dec 2022 | Foutloos | $163.91 |

De functie inquartertodate() retourneert een booleaanse waarde bij het evalueren van de productiedatums van elk product. Voor degenen die een booleaanse waarde van TRUE retourneren, markeert het de producten als ‘Defective’. Voor elk product dat een waarde retourneert van FALSE, en dus niet gemaakt in het kwartaal tot en met 15 mei, markeert het de producten als ‘Faultless’.