inmonth - script- en diagramfunctie

Deze functie retourneert True als timestamp in de maand valt die base_date bevat.

Syntaxis:

InMonth (timestamp, base_date, period_no)

Diagram met de voorwaarden van de functie inmonth. — Diagram van indaytotime-functie.

Met andere woorden, de functie inmonth() bepaalt of een reeks datums in deze maand valt en retourneert een booleaanse waarde op basis van een base_date die de maand identificeert.

Wanneer gebruiken

De functie inmonth() retourneert een booleaanse waarde. Dit type functie wordt doorgaans gebruikt als voorwaarde in een if expression. Hierdoor wordt een aggregatie of berekening geretourneerd, afhankelijk van of een datum plaatsvond in de maand, inclusief de desbetreffende datum.

De functie inmonth() bijvoorbeeld kan worden gebruikt om alle materieel te identificeren die in een specifieke maand is geproduceerd.

Retourgegevenstypen: Booleaanse waarde

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

Argumenten
Argument	Beschrijving
tijdstempel	De datum die u wilt vergelijken met base_date.
base_date	Datum op basis waarvan de maand wordt geëvalueerd. Het is belangrijk op te merken dat de base_date elke dag binnen een maand kan zijn.
period_no	De maand kan worden verschoven met period_no. period_no is een geheel getal, waarbij de waarde 0 de maand aangeeft die base_date bevat. Negatieve waarden in period_no geven voorafgaande maanden aan en positieve waarden geven volgende maanden aan.

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
inmonth ('25/01/2013', '01/01/2013', 0)	Retourneert True
inmonth('25/01/2013', '23/04/2013', 0)	Retourneert False
inmonth ('25/01/2013', '01/01/2013', -1)	Retourneert False
inmonth ('25/12/2012', '17/01/2013', -1)	Retourneert True

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 de eerste helft van 2022.
Een voorafgaande lading met een extra variabele, 'in_month', die bepaalt of transacties in april hebben plaatsgevonden.

Load-script

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
  Load 
    *, 
    inmonth(date,'04/01/2022', 0) as in_month 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/10/2022',37.23 
8189,'1/14/2022',17.17 
8190,'1/20/2022',88.27 
8191,'1/22/2022',57.42 
8192,'2/1/2022',53.80 
8193,'2/2/2022',82.06 
8194,'2/20/2022',40.39 
8195,'4/11/2022',87.21 
8196,'4/13/2022',95.93 
8197,'4/15/2022',45.89 
8198,'4/25/2022',36.23 
8199,'5/20/2022',25.66 
8200,'5/22/2022',82.77 
8201,'6/19/2022',69.98 
8202,'6/22/2022',76.11 
];

Resultaten

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

date
in_month

Voorbeelden van functies
date	in_month
1/10/2022	0
1/14/2022	0
1/20/2022	0
1/22/2022	0
2/1/2022	0
2/2/2022	0
2/20/2022	0
4/11/2022	-1
4/13/2022	-1
4/15/2022	-1
4/25/2022	-1
5/20/2022	0
5/22/2022	0
6/19/2022	0
6/22/2022	0

Het veld ‘in_month’ wordt gemaakt in de voorafgaande load-instructie met behulp van de functie inmonth() en geeft het datumveld door, een vastgelegde datum van 1 april, als onze base_date en een period_no van 0 als de argumenten van de functie.

De base_date identificeert de maand die het booleaanse resultaat TRUE zal opleveren. Daarom retourneren alle transacties die in april hebben plaatsgevonden TRUE, wat wordt gevalideerd in de resultatentabel.

Voorbeeld 2 – period_no

Overzicht

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

In dit voorbeeld maakt u echter een veld '2_months_prior' aan dat bepaalt of de transacties twee maanden voor april hebben plaatsgevonden.

Load-script

SET DateFormat='MM/DD/YYYY'; 
 
Transactions: 
Load 
   *, 
   inmonth(date,'04/01/2022', -2) as [2_months_prior] 
Inline  
[ 
id,date,amount 
8188,'1/10/2022',37.23 
8189,'1/14/2022',17.17 
8190,'1/20/2022',88.27 
8191,'1/22/2022',57.42 
8192,'2/1/2022',53.80 
8193,'2/2/2022',82.06 
8194,'2/20/2022',40.39 
8195,'4/11/2022',87.21 
8196,'4/13/2022',95.93 
8197,'4/15/2022',45.89 
8198,'4/25/2022',36.23 
8199,'5/20/2022',25.66 
8200,'5/22/2022',82.77
8201,'6/19/2022',69.98 
8202,'6/22/2022',76.11 
];

Resultaten

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

date
2_months_prior

Voorbeelden van functies
date	2_months_prior
1/10/2022	0
1/14/2022	0
1/20/2022	0
1/22/2022	0
2/1/2022	-1
2/2/2022	-1
2/20/2022	-1
4/11/2022	0
4/13/2022	0
4/15/2022	0
4/25/2022	0
5/20/2022	0
5/22/2022	0
6/19/2022	0
6/22/2022	0

Als u -2 gebruikt als het period_no-argument in de inmonth()-functie, verschuift de maand gedefinieerd door het base_date-argument naar twee maanden eerder. In dit voorbeeld verandert het de gedefinieerde maand van april in februari.

Daarom zal elke transactie die in februari plaatsvindt een booleaans resultaat van TRUE retourneren.

Voorbeeld 3 – Diagramobject

Overzicht

Dezelfde gegevensset en het scenario uit de vorige voorbeelden worden gebruikt.

In dit voorbeeld is de gegevensverzameling echter niet gewijzigd en wordt in de applicatie geladen. De berekening die bepaalt of transacties plaatsvonden in april is gemaakt als meting in een diagramobject van de toepassing.

Load-script

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/10/2022',37.23 
8189,'1/14/2022',17.17 
8190,'1/20/2022',88.27 
8191,'1/22/2022',57.42 
8192,'2/1/2022',53.80 
8193,'2/2/2022',82.06 
8194,'2/20/2022',40.39 
8195,'4/11/2022',87.21 
8196,'4/13/2022',95.93 
8197,'4/15/2022',45.89 
8198,'4/25/2022',36.23 
8199,'5/20/2022',25.66 
8200,'5/22/2022',82.77 
8201,'6/19/2022',69.98 
8202,'6/22/2022',76.11 
];

Diagramobject

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

date

Maak de volgende meting om te berekenen of een transactie plaatsvindt in april:

=inmonth(date,'04/01/2022', 0)

Resultaten

Voorbeelden van functies
date	=inmonth(date,'04/01/2022', 0)
1/10/2022	0
1/14/2022	0
1/20/2022	0
1/22/2022	0
2/1/2022	0
2/2/2022	0
2/20/2022	0
4/11/2022	-1
4/13/2022	-1
4/15/2022	-1
4/25/2022	-1
5/20/2022	0
5/22/2022	0
6/19/2022	0
6/22/2022	0

Voorbeeld 4 – Scenario

Overzicht

In dit voorbeeld wordt een gegevensset geladen in de tabel ‘Products’. De tabel bevat de volgende velden:

Product-id
Productiedatum
Kostprijs

Door een fout in de apparatuur waren producten die in de maand juli 2022 zijn geproduceerd defect. Het probleem is op 27 juli 2022 opgelost.

De eindgebruiker wil graag een diagram dat op maand de status toont van producten die zijn geproduceerd als 'defect' (booleaans WAAR) of 'foutloos' (booleaans NIET WAAR) en de kosten van de producten die in die maand zijn geproduceerd.

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

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

=monthname(manufacture_date)

Maak de volgende metingen

=sum(cost_price)
=if(only(inmonth(manufacture_date,makedate(2022,07,01),0)),'Defective','Faultless')

Stel de Getalnotatie van de meting in op Geld.
Onder Uiterlijk schakelt u Totaal uit.

Resultatentabel
monthname(manufacture_date)	=if(only(inmonth(manufacture_date,makedate(2022,07,01),0)),'Defective','Faultless')	sum(cost_price)
januari 2022	Foutloos	$54.40
februari 2022	Foutloos	$145.69
maart 2022	Foutloos	$53.80
april 2022	Foutloos	$82.06
mei 2022	Foutloos	$127.60
juni 2022	Foutloos	$141.82
juli 2022	Defect	$214.64
augustus 2022	Foutloos	$147.46
september 2022	Foutloos	$84.21
oktober 2022	Foutloos	$163.91

De functie inmonth() retourneert een booleaanse waarde bij het evalueren van de productiedatums van elk product. Voor elk product dat in juli 2022 is geproduceerd, retourneert de functie inmonth() een booleaanse waarde voor Waar en markeert de producten als 'Defect'. Voor elk product dat de waarde voor Niet waar retourneert, en dus niet op in juli is geproduceerd, wordt het product als 'Foutloos' gemarkeerd.

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