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.

Syntaxis:

InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])

Retourgegevenstypen: Booleaanse waarde

Diagram dat laat zien hoe de inmonthstodate-functie kan worden gebruikt om te bepalen of een tijdstempel al dan niet in een bepaald tijdsegment valt. — Diagram van 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 toont het bereik van de booleaanse resultaten van de inmonthstodate-functie. — Diagram van booleaans resultatenbereik van de inmonthstodate-functie.

De volgende segmenten van het jaar zijn beschikbaar in de functie als n_month-argumenten:

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. Dit type functie wordt doorgaans 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/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.

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

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 wordt in de tabel Transactions geladen.
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 veld in_months_to_date wordt gemaakt in de vorige load-instructie met behulp van de functie inmonthstodate().

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 dat het bereik van transacties toont waarbij de inmonthstodate-functie de waarde TRUE heeft vastgesteld. — Diagram van 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

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 toont het transactiebereik met het period_no-argument ingesteld op -1. — Diagram van functie 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

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 het jaar op 1 maart en wordt het jaar vervolgens in kwartalen verdeeld op basis van het eerste argument dat is opgegeven. 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 toont het transactiebereik met de eerste maand van het jaar ingesteld op maart. — Diagram van de 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

Overzicht

Dezelfde gegevensverzameling en het scenario uit het eerste voorbeeld worden gebruikt.

In dit voorbeeld is de gegevensverzameling niet gewijzigd en wordt in de app geladen. Er moet een berekening worden gemaakt die bepaalt welke transacties plaatsvonden in hetzelfde kwartaal als 15 mei, wordt gemaakt als een meting in een diagram in de app.

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.

Diagram toont het transactiebereik waarbij een booleaanse waarde voor TRUE wordt geretourneerd. — Diagram van de 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

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:

Klik in het bedrijfsmiddelenvenster op Aangepaste objecten.
Selecteer Qlik Dashboard-bundel en voeg een variabele-invoer toe aan uw werkblad.
Voer een titel in voor het diagram.
Selecteer onder Variabele de optie vPeriod als de naam en stel het object in om als een Vervolgkeuzelijst te worden weergegeven.
Klik onder Waarden op Dynamische waarden. Voer het volgende in:
```
='1~month|2~bi-month|3~quarter|4~tertial|6~half-year'.
```
Voeg een nieuwe tabel toe aan het werkblad.
Voeg in het eigenschappenvenster onder Gegevens product_type toe als een dimensie.
Voeg de volgende uitdrukking als een meting toe:

=sum(if(inmonthstodate($(vPeriod),sales_date,makedate(2022,12,24),0),sales_price,0))
Stel de Getalnotatie van de meting in op Geld.

Resultatentabel
product_type	=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.

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