inyear - script- en diagramfunctie

Deze functie retourneert True als timestamp binnen het jaar valt dat base_date bevat.

Syntaxis:

InYear (timestamp, base_date, period_no [, first_month_of_year])

Retourgegevenstypen: Booleaanse waarde

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

Diagram dat het tijdbereik weergeeft die de inyear()-functie evalueert en een booleaans resultaat retourneert, afhankelijk van de plaatsing van de basisdatum. — Diagram van het bereik van de inyear()-functie

De inyear()-functie retourneert een booleaans resultaat wanneer de geselecteerde datumwaarde worden vergeleken met een jaar dat is gedefinieerd door de base_date.

Wanneer gebruiken

De functie inyear() 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 het feit of een geëvalueerde datum in het desbetreffende jaar plaatsvond. De inyear()-functie kan bijvoorbeeld worden gebruikt om alle verkoop te identificeren die in een bepaald jaar heeft plaatsgevonden.

Argumenten
Argument	Beschrijving
timestamp	De datum die u wilt vergelijken met base_date.
base_date	Datum op basis waarvan het jaar wordt geëvalueerd.
period_no	Het jaar kan worden verschoven met period_no. period_no is een geheel getal, waarbij de waarde 0 het jaar aangeeft dat base_date bevat. Negatieve waarden in period_no geven voorafgaande jaren aan en positieve waarden geven volgende jaren 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.

U kunt de volgende waarden gebruiken om de eerste maand van het jaar in te stellen in het argument first_month_of_year:

waarden first_month_of_year
Month	Waarde
Februari	2
Maart	3
April	4
May	5
Juni	6
Juli	7
Augustus	8
September	9
Oktober	10
November	11
December	12

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
inyear ('01/25/2013', '01/01/2013', 0 )	Retourneert TRUE
inyear ('01/25/2012', '01/01/2013', 0)	Retourneert FALSE
inyear ('01/25/2013', '01/01/2013', -1)	Retourneert FALSE
inyear ('01/25/2012', '01/01/2013', -1 )	Retourneert TRUE
inyear ('01/25/2013', '01/01/2013', 0, 3)	Retourneert TRUE De waarde van de base_date en de first_month_of_year specificeren dat een tijdstempel tussen 01/03/2012 en 02/28/2013 moet vallen
inyear ('03/25/2013', '07/01/2013', 0, 3 )	Retourneert TRUE

Voorbeeld 1 – Basisvoorbeeld

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 tussen 2020 en 2022 die wordt geladen in de tabel Transactions.
Een voorafgaande lading met de inyear()-functie die is ingesteld als het in_year-veld en die bepaalt welke transacties in hetzelfde jaar hebben plaatsgevonden als het jaar waarin 26 juli 2021 valt.

Load-script

SET DateFormat='MM/DD/YYYY'; 
Transactions: 
    Load 
        *, 
        inyear(date,'07/26/2021', 0) as in_year 
        ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];

Resultaten

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

date
in_year

Resultatentabel
date	in_year
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
12/27/2021	-1
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Het veld in_year wordt gemaakt in de vorige load-instructie met behulp van de functie inyear(). Het eerste argument identificeert welk veld wordt geëvalueerd. Het tweede argument is een vastgestelde datum voor 26 juli 2021. Dit is de base_date die het jaar bepaalt waarmee de vergelijking moet worden gedaan. Een period_no van 0 is het laatste argument, wat betekent dat de inyear()-functie geen jaren voor of na het jaar vergelijkt.

Diagram van de inyear()-functie met 26 juli als de basisdatum en een gemarkeerd tijdbereik van 1 januari 2021 tot 1 januari 2022. — Diagram van het bereik van de inyear()-functie met 26 juli als de basisdatum

Een transactie die in 2021 plaatsvindt, retourneert een booleaans resultaat voor TRUE.

Voorbeeld 2 – period_no

Overzicht

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

Het load-script bevat:

Een gegevensset met een set transacties tussen 2020 en 2022 die wordt geladen in de tabel Transactions.
Een voorafgaande lading met de inyear()-functie die is ingesteld als het previous_year-veld en die bepaalt welke transacties in hetzelfde jaar hebben plaatsgevonden als het jaar waarin 26 juli 2021 valt.

Load-script

SET DateFormat='MM/DD/YYYY'; 
Transactions: 
    Load 
        *, 
        inyear(date,'07/26/2021', -1) as previous_year 
        ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];

Resultaten

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

date
previous_year

Resultatentabel
date	previous_year
01/13/2020	-1
02/26/2020	-1
03/27/2020	-1
04/16/2020	-1
05/21/2020	-1
08/14/2020	-1
10/07/2020	-1
12/05/2020	-1
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
12/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Met -1 als het period_no-argument in de inyear()-functie verschuiven de grenzen van het jaar waarmee de vergelijking moet worden gedaan met een heel jaar. 2021 wordt aanvankelijk geïdentificeerd als het jaar voor de vergelijking. De period_no verschuift het jaar waarmee moet worden vergeleken met één jaar waardoor 2020 het jaar is voor de vergelijking.

Diagram van de inyear()-functie waarbij 26 juli de basisdatum is en het argument voor de period_no is ingesteld op -1. — Diagram van het bereik van de inyear()-functie met het argument voor de period_no ingesteld op -1

Daarom zal een transactie die in 2020 plaatsvindt, een booleaans resultaat voor TRUE retourneren.

Voorbeeld 3 – first_month_of_year

Overzicht

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

Het load-script bevat:

Een gegevensset met een set transacties tussen 2020 en 2022 die wordt geladen in de tabel Transactions.
Een voorafgaande lading met de inyear()-functie die is ingesteld als het in_year-veld en die bepaalt welke transacties in hetzelfde jaar hebben plaatsgevonden als het jaar waarin 26 juli 2021 valt.

In dit voorbeeld is maart volgens het organisatiebeleid echter de eerste maand van het financiële boekjaar.

Load-script

SET DateFormat='MM/DD/YYYY'; 
Transactions: 
    Load 
        *, 
        inyear(date,'07/26/2021', 0, 3) as in_year 
        ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];

Resultaten

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

date
in_year

Resultatentabel
date	in_year
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
12/27/2021	-1
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Met 3 als het first_month_of_year-argument in de inyear()-functie begint het jaar op 1 maart en eindigt het jaar aan het eind van februari.

Diagram van de inyear()-functie waarbij 26 is ingesteld als de basisdatum en de eerste maand van het jaar is ingesteld op maart. — Diagram van het tijdsbereik van de inyear()-functie met maart ingesteld als de eerste maand van het jaar

Daarom zal elke transactie die plaatsvindt tussen 1 maart 2021 en 1 maart 2022 een booleaans resultaat voor TRUE retourneren.

Voorbeeld 4 – Diagramobjectvoorbeeld

Overzicht

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

In dit voorbeeld is de gegevensverzameling echter niet gewijzigd en wordt in de applicatie geladen. De berekening die bepaalt of transacties al dan niet hebben plaatsgevonden in hetzelfde jaar als 26 juli 2021, wordt als meting in een diagramobject van de applicatie gemaakt.

Load-script

SET DateFormat='MM/DD/YYYY'; 
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/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 jaar hebben plaatsgevonden als het jaar waarin 26 juli 2021 valt, maakt u de volgende meting:

=inyear(date,'07/26/2021', 0)

Resultatentabel
date	=inyear(date,'07/26/2021',0)
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
12/27/2021	-1
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Het veld in_year wordt in een diagram gemaakt met behulp van de functie inyear(). Het eerste argument identificeert welk veld wordt geëvalueerd. Het tweede argument is een vastgestelde datum voor 26 juli 2021. Dit is de base_date die het jaar bepaalt waarmee de vergelijking moet worden gedaan. Een period_no van 0 is het laatste argument, wat betekent dat de inyear()-functie geen jaren voor of na het jaar vergelijkt.

Diagram van de inyear()-functie met 27 juli als de basisdatum en een gemarkeerd tijdsbereik van 1 januari 2021 tot 1 januari 2022. — Diagram van het bereik van de inyear()-functie met 27 juli als de basisdatum

Een transactie die in 2021 plaatsvindt, retourneert een booleaans resultaat voor TRUE.

Voorbeeld 5 – Scenario

Overzicht

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

Het load-script bevat:

Een gegevensset die in de tabel Products wordt geladen.
De tabel bevat de volgende velden:
- product ID
- producttype
- productiedatum
- cost price

De eindgebruiker wil een diagramobject dat, per producttype, de kosten weergeeft van de producten die in 2021 zijn geproduceerd.

Load-script

Products: 
Load 
* 
Inline  
[ 
product_id,product_type,manufacture_date,cost_price 
8188,product A,'01/13/2020',37.23 
8189,product B,'02/26/2020',17.17 
8190,product B,'03/27/2020',88.27 
8191,product C,'04/16/2020',57.42 
8192,product D,'05/21/2020',53.80 
8193,product D,'08/14/2020',82.06 
8194,product C,'10/07/2020',40.39 
8195,product B,'12/05/2020',87.21
8196,product A,'01/22/2021',95.93 
8197,product B,'02/03/2021',45.89 
8198,product C,'03/17/2021',36.23 
8199,product C,'04/23/2021',25.66
8200,product B,'05/04/2021',82.77 
8201,product D,'06/30/2021',69.98 
8202,product D,'07/26/2021',76.11 
8203,product D,'12/27/2021',25.12 
8204,product C,'06/06/2022',46.23 
8205,product C,'07/18/2022',84.21 
8206,product A,'11/14/2022',96.24 
8207,product B,'12/12/2022',67.67 
];

Resultaten

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

product_type

Om de som van elk product dat in 2021 is geproduceerd te berekenen, maakt u de volgende meting:

=sum(if(InYear(manufacture_date,makedate(2021,01,01),0),cost_price,0))

Doe het volgende:

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

Resultatentabel
product_type	=sum(if(InYear(manufacture_date,makedate(2021,01,01),0),cost_price,0))
product A	$95.93
product B	$128.66
product C	$61.89
product D	$171.21

De functie inyear() retourneert een booleaanse waarde bij het evalueren van de productiedatums van elk product. Voor elk product dat in 2021 is geproduceerd, retourneert de inyear()-functie een booleaanse waarde voor TRUE en wordt de som van de cost_priceweergegeven.

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