# inmonthstodate Script- en diagramfunctie
Deze functie bepaalt of een tijdstempel binnen het gedeelte van een periode van de maand, twee maanden, kwartaal, tertiaal of half jaar tot en met de laatste milliseconde van `base_date` valt. Het is tevens mogelijk om te bepalen of de tijdstempel binnen een voorafgaande of volgende tijdsperiode valt.
InMonths (n\_months, timestamp, base\_date, period\_no[, first\_month\_of\_year ])
Retourgegevenstypen: Booleaanse waarde
Diagram van `inmonthstodate`-functie.
Diagram van `inmonthstodate`-functie.
Diagram van `inmonthstodate`inmonthstodate-functie. 
Argumenten
| Argument | Beschrijving |
| --- | --- |
| n\_months | Het aantal maanden dat de periode definieert. Een geheel getal of uitdrukking die wordt herleid tot een geheel getal dat een van de volgende waarden moet hebben: 1 (equivalent aan de functie inmonth()), 2 (2 maanden), 3 (equivalent aan de functie inquarter()), 4 (tertiaal) of 6 (half jaar). |
| timestamp | De datum die u wilt vergelijken met base\_date. |
| base\_date | Datum op basis waarvan de periode wordt geëvalueerd. |
| period\_no | De periode kan worden verschoven met period\_no, een geheel getal of een uitdrukking die wordt herleid tot een geheel getal, waarbij de waarde 0 de periode aangeeft die base\_date bevat. Negatieve waarden in period\_no geven voorafgaande perioden aan en positieve waarden geven volgende perioden 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. |
In de `inmonthstodate()`-functie functioneert de `base_date` als het eindpunt van een specifiek jaarsegment waar het onderdeel van is.
Als het jaar bijvoorbeeld in drie segmenten is verdeeld en de `base_date` 15 mei was, zou iedere tijdstempel tussen het begin van januari en het eind van april een booleaans resultaat FALSE retourneren. Datums tussen 1 mei en 15 mei zouden TRUE retourneren. De rest van het jaar zou FALSE retourneren.
Diagram van booleaans resultatenbereik van de `inmonthstodate`-functie.
Diagram van booleaans resultatenbereik van de `inmonthstodate`-functie.
Diagram van booleaans resultatenbereik van de `inmonthstodate`inmonthstodate-functie. 
De volgende segmenten van het jaar zijn beschikbaar in de functie als `n_month`-argumenten:
`n_month`n\_month argumenten
| Periode | Aantal maanden |
| --- | --- |
| maandelijks | 1. |
| tweemaandelijks | 2 |
| kwartaal | 3 |
| viermaandelijks | 4 |
| halfjaarlijks | 6 |
Wanneer gebruiken
De functie `inmonthstodate()` retourneert een booleaanse waarde. Doorgaans wordt dit type functie gebruikt als voorwaarde in een `if expression`. Door de `inmonthstodate()`-functie te gebruiken, kunt u de periode selecteren die u wilt laten evalueren. Bijvoorbeeld: door een invoervariabele te geven waarmee de gebruiker producten kan identificeren die in de maand, het kwartaal of de jaarhelft van een periode tot een bepaalde datum zijn geproduceerd.
## 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.
Voorbeelden van functies
| Voorbeeld | Resultaat |
| --- | --- |
| `inmonthstodate(4, '01/25/2013', '04/25/2013',
0)` | Retourneert True omdat de waarde van de timestamp, 01/25/2013, binnen de periode van vier maanden van 01/01/2013 tot het einde van 04/25/2013 ligt, waarin de waarde van base\_date, 04/25/2013 ligt. |
| `inmonthstodate(4, '04/26/2013', '04/25/2006',
0)` | Retourneert False, omdat 04/26/2013 buiten dezelfde periode als het voorafgaande voorbeeld ligt. |
| `inmonthstodate(4, '09/25/2005', '02/01/2006',
-1)` | Retourneert True, omdat de waarde van period\_no, -1, de zoekperiode één periode van vier maanden (de waarde van n-months) terugschuift, waardoor de zoekperiode van 01/09/2005 t/m 02/01/2006 valt. |
| `inmonthstodate(4, '04/25/2006', '06/01/2006',
0, 3)` | Retourneert True, omdat de waarde van first\_month\_of\_year is ingesteld op 3, waardoor de zoekperiode van 03/01/2006 t/m 06/01/2006 valt in plaats van van 05/01/2006 t/m 06/01/2006. |
## Voorbeeld 1 – geen aanvullende argumenten
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.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 gegevensset met een reeks transacties voor 2022 die wordt geladen in een tabel met de naam ‘`Transactions`’.
* Een datumveld dat wordt weergegeven in de `DateFormat`-systeemvariabele met de notatie `(MM/DD/YYYY)`.
* Een voorgaande load-instructie met:
* De `inmonthstodate()`-functie die is ingesteld als het veld `in_months_to_date`. Dit bepaalt welke transacties hebben plaatsgevonden in het kwartaal tot 15 mei 2022.
Load-script
```
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthstodate(3,date,'05/15/2022', 0) as in_months_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_months_to_date`
Resultatentabel
| date | in\_months\_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 ‘`in_months_to_date`’-veld wordt gemaakt in de voorafgaande load-instructie met behulp van de `inmonthstodate()`-functie.
Het eerste opgegeven argument is `3`, waarbij het jaar wordt verdeeld in kwartaalsegmenten. Het tweede argument geeft aan welk veld wordt geëvalueerd. Het derde argument is een vastgestelde datum voor 15 mei, wat de `base_date` is die de eindgrens van het segment definieert. Een `period_no` van `0` is het laatste argument.
Diagram van `inmonthstodate`-functie zonder aanvullende argumenten.
Diagram van `inmonthstodate`-functie zonder aanvullende argumenten.
Diagram van `inmonthstodate`inmonthstodate-functie zonder aanvullende argumenten. 
Elke transactie die tussen 1 april en 15 mei plaatsvindt, retourneert een booleaans resultaat voor TRUE. Transactiedatums buiten die periode retourneren FALSE.
## Voorbeeld 2 – period\_no
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.htm)
#### Load-script en resultaten
Overzicht
Dezelfde gegevensverzameling en het scenario uit het eerste voorbeeld worden gebruikt.
In dit voorbeeld wordt echter een veld gemaakt, `previous_qtr_to_date`, dat bepaalt of de transacties plaatsvonden in een kwartaal vóór 15 mei.
Load-script
```
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthstodate(3,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 |
Door `-1` als het `period_no`-argument te gebruiken in de `inmonthstodate()`-functie, verschuift de functie de grenzen van het jaarsegment in de vergelijking met een kwartaal.
15 mei valt in het tweede kwartaal van het jaar en dus komt het segment aanvankelijk overeen met de ingestelde periode tussen 1 april en 15 mei. Het `period_no`-argument verschuift dit segment met een negatieve periode van drie maanden. De datumgrenzen worden 1 januari t/m 15 februari.
Diagram van functie `inmonthstodate` waarbij period\_no is ingesteld op -1.
Diagram van functie `inmonthstodate` waarbij period\_no is ingesteld op -1.
Diagram van functie `inmonthstodate`inmonthstodate waarbij period\_no is ingesteld op -1. 
Daarom zal elke transactie die plaatsvindt tussen 1 januari en 15 februari een booleaans resultaat voor TRUE retourneren.
## Voorbeeld 3 – first\_month\_of\_year
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.htm)
#### Load-script en resultaten
Overzicht
Dezelfde gegevensverzameling en het scenario uit het eerste voorbeeld worden gebruikt.
In dit voorbeeld is maart volgens het organisatiebeleid de eerste maand van het boekjaar.
Maak een veld, `in_months_to_date`, dat bepaalt welke transacties hebben plaatsgevonden in hetzelfde kwartaal tot en met 15 mei 2022.
Load-script
```
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthstodate(3,date,'05/15/2022', 0,3) as in_months_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_months_to_date`
Resultatentabel
| date | previous\_qtr\_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 `inmonthstodate()`-functie, begint de functie het jaar op 1 maart en verdeelt het jaar vervolgens in kwartalen op basis van het eerste opgegeven argument. Daarom zijn de kwartaalsegmenten:
* Maa-mei
* Jun-aug
* Sep-nov
* Dec-feb
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 de `inmonthstodate`-functie waarbij maart is ingesteld als de eerste maand van het jaar.
Diagram van de `inmonthstodate`-functie waarbij maart is ingesteld als de eerste maand van het jaar.
Diagram van de `inmonthstodate`inmonthstodate-functie waarbij maart is ingesteld als de eerste maand van het jaar. 
Daarom zal elke transactie die plaatsvindt tussen 1 maart en 15 mei een booleaans resultaat voor TRUE retourneren, terwijl transacties met datums buiten deze grenzen een waarde voor FALSE zullen retourneren.
## Voorbeeld 4 – diagramvoorbeeld
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.htm)
#### Load-script en diagramuitdrukking
Overzicht
Dezelfde gegevensverzameling en het scenario uit het eerste voorbeeld worden gebruikt.
In dit voorbeeld is de gegevensverzameling ongewijzigd en geladen in de applicatie. De taak is om een berekening te maken die bepaalt of transacties plaatsvonden in hetzelfde kwartaal als 15 mei, als een meting in een diagram van de applicatie.
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`
Om te berekenen of transacties in hetzelfde kwartaal hebben plaatsgevonden als het kwartaal waarin 15 mei valt, maakt u de volgende meting:
`=inmonthstodate(3,date,'05/15/2022', 0)`
Resultatentabel
| date | =inmonthstodate(3,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_months_to_date` wordt in het diagram gemaakt met behulp van de `inmonthstodate()`-functie.
Het eerste opgegeven argument is `3`, waarbij het jaar wordt verdeeld in kwartaalsegmenten. Het tweede argument geeft aan welk veld wordt geëvalueerd. Het derde argument is een vastgestelde datum voor 15 mei. Dit is de `base_date` die de eindgrens van het segment definieert. Een `period_no` van `0` is het laatste argument.
Diagram van de `inmonthstodate`-functie met kwartaalsegmenten.
Diagram van de `inmonthstodate`-functie met kwartaalsegmenten.
Diagram van de `inmonthstodate`inmonthstodate-functie met kwartaalsegmenten. 
Elke transactie die tussen 1 april en 15 mei plaatsvindt, retourneert een booleaans resultaat voor TRUE. Transactiedatums buiten dat segment retourneren FALSE.
## Voorbeeld 5 – Scenario
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.htm)
#### Load-script en resultaten
Overzicht
In dit voorbeeld wordt een gegevensset geladen in de tabel ‘Sales’. De tabel bevat de volgende velden:
* Product-id
* Producttype
* Verkoopdatum
* Verkoopprijs
De eindgebruiker wil een diagram dat de verkoop van producten op producttype weergeeft van producten die in de periode voorafgaand aan 24 december 2022 zijn verkocht. De gebruiker wil de duur van deze periode kunnen definiëren.
Load-script
```
SET vPeriod = 1;
Products:
Load
*
Inline
[
product_id,product_type,sales_date,sales_price
8188,product A,'9/19/2022',37.23
8189,product D,'10/27/2022',17.17
8190,product C,'10/30/2022',88.27
8191,product B,'10/31/2022',57.42
8192,product D,'11/16/2022',53.80
8193,product D,'11/28/2022',82.06
8194,product A,'12/2/2022',40.39
8195,product B,'12/5/2022',87.21
8196,product C,'12/15/2022',95.93
8197,product B,'12/16/2022',45.89
8198,product C,'12/19/2022',36.23
8199,product D,'12/22/2022',25.66
8200,product D,'12/23/2022',82.77
8201,product A,'12/24/2022',69.98
8202,product A,'12/24/2022',76.11
8203,product B,'12/26/2022',25.12
8204,product B,'12/27/2022',46.23
8205,product B,'12/27/2022',84.21
8206,product C,'12/28/2022',96.24
8207,product D,'12/29/2022',67.67
];
```
Resultaten
Laad de gegevens en open een werkblad.
Aan het begin van het load-script is een variabele, vPeriod, gemaakt die wordt gekoppeld aan het besturingselement voor variabeleninvoer.
Doe het volgende:
1. Klik in het bedrijfsmiddelenvenster op Diagrammen.
2. Sleep onder Dashboardobjecten een Variabele invoer naar het werkblad.
3. Voer een titel in voor het diagram.
4. Selecteer onder Variabele de optie vPeriod als de naam en stel het object in om als een Vervolgkeuzelijst te worden weergegeven.
5. Klik onder Waarden op Dynamische waarden. Voer het volgende in:
```
='1~month|2~bi-month|3~quarter|4~tertial|6~half-year'.
```
6. Voeg een nieuwe tabel toe aan het werkblad.
7. Voeg in het eigenschappenvenster onder Gegevens product\_type toe als een dimensie.
8. Voeg de volgende uitdrukking als een meting toe:
=sum(if(inmonthstodate($(vPeriod),sales\_date,makedate(2022,12,24),0),sales\_price,0))
9. Stel de Getalnotatie van de meting in op Geld.
Resultatentabel
| producttype | =sum(if(inmonthstodate($(vPeriod),sales\_date,makedate(2022,12,24),0),sales\_price,0)) |
| --- | --- |
| product A | $186.48 |
| product B | $190.52 |
| product C | $220.43 |
| product D | $261.46 |
De inmonthstodate()-functie gebruikt de invoer van de gebruiker als argument om de omvang van het beginsegment van het jaar te definiëren.
De functie passeert in de verkoopdatum van elk van de producten als het tweede argument van de inmonthstodate()-functie. Door 24 december te gebruiken als het derde argument in de inmonthstodate()-functie, retourneren producten met een verkoopdatum die binnen de gedefinieerde periode tot en met 24 december valt, een booleaanse waarde voor TRUE. De somfunctie telt de verkoop van deze producten bij elkaar op.