weekname - script- en diagramfunctie

Deze functie retourneert het jaar en weeknummer met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de week die date bevat.

Syntaxis:

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

De functie weekname() bepaalt in welke week de datum valt en retourneert het weeknummer en het jaar van die week. De eerste dag van de week wordt bepaald door de systeemvariabele FirstWeekDay. U kunt echter ook de eerste dag van de week wijzigen door het argument first_week_day in de functie weekname() te gebruiken.

In Qlik Sense worden de landinstellingen opgehaald wanneer de app wordt gemaakt en de bijbehorende instellingen worden als omgevingsvariabelen opgeslagen in het script.

Een Noord-Amerikaanse app-ontwikkelaar krijgt vaak Set BrokenWeeks=1; in het script, wat overeenkomt met gebroken weken. Een Europese app-ontwikkelaar krijgt vaak Set BrokenWeeks=0; in het script, wat overeenkomt met ongebroken weken.

Als uw applicatie gebroken weken gebruikt, dan begint het weeknummer op 1 januari en eindigt op de dag voorafgaand aan de systeemvariabele FirstWeekDay, ongeacht hoeveel dagen er zijn verstreken.

Als uw toepassing echter ononderbroken weken gebruikt, kan week 1 in het voorgaande jaar of in de eerste paar dagen van januari beginnen. Dit hangt af van hoe u de systeemvariabelen ReferenceDay en FirstWeekDay gebruikt.

Voorbeeld van de functie Weekname
Date	ISO-weeknaam	US-weeknaam
Za 2020 Dec 26	2020/52	2020/52
Zo 2020 Dec 27	2020/52	2020/53
Ma 2020 Dec 28	2020/53	2020/53
Di 2020 Dec 29	2020/53	2020/53
Wo 2020 Dec 30	2020/53	2020/53
Do 2020 Dec 31	2020/53	2020/53
Vr 2021 Jan 1	2020/53	2021/01
Za 2021 Jan 2	2020/53	2021/01
Zo 2021 Jan 3	2020/53	2021/02
Ma 2021 Jan 4	2021/01	2021/02
Di 2021 Jan 5	2021/01	2021/02

Wanneer gebruiken

De functie weekname() is handig als u aggregaties per week wilt vergelijken.

Bijvoorbeeld als u de totale verkoop van producten per week wilt zien. Gebruik weekname() in plaats van lunarweekname() om consistentie te behouden met de omgevingsvariabele BrokenWeeks in de toepassing. Als de toepassing ononderbroken weken gebruikt, kan week 1 datums van december van het voorgaande jaar bevatten of datums in januari van het lopende jaar uitsluiten. Als de toepassing gebruikmaakt van gebroken weken, kan week 1 minder dan zeven dagen bevatten.

Retourgegevenstypen: dual

Argumenten
Argument	Beschrijving
timestamp	De te evalueren datum of tijdstempel.
period_no	shift is een geheel getal, waarbij de waarde 0 de week aangeeft die date bevat. Negatieve waarden in verschuiving geven voorgaande weken aan en positieve waarden geven volgende weken aan.
first_week_day	Geeft de dag op waarop de week begint. Bij weglating wordt de waarde van de variabele FirstWeekDay gebruikt. De mogelijke first_week_day-waarden zijn 0 voor maandag, 1 voor dinsdag, 2 voor woensdag, 3 voor donderdag, 4 voor vrijdag, 5 voor zaterdag en 6 voor zondag. Zie FirstWeekDay voor meer informatie over de systeemvariabele.
broken_weeks	Als u broken_weeks (gebroken weken) niet specificeert, dan wordt de waarde van variabele BrokenWeeks gebruikt om te definiëren of weken al dan niet gebroken zijn. Zie BrokenWeeks voor meer informatie over de systeemvariabele
reference_day	Als u reference_day (referentiedag) niet specificeert, dan wordt de waarde van variabele ReferenceDay gebruikt om te definiëren welke dag in januari wordt ingesteld als referentiedag om week 1 te definiëren. Standaard wordt in Qlik Sense-functies 4 gebruikt als de referentiedag. Dit betekent dat week 1 4 januari moet bevatten of, anders gezegd, dat week 1 altijd ten minste 4 dagen in januari moet hebben. Zie ReferenceDay voor meer informatie over de systeemvariabele

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.

Standaard landinstellingen in apps 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 gebruikersinterface van Qlik Sense. Qlik Sense wordt weergegeven in dezelfde taal als de browser die u gebruikt.

De onderstaande voorbeelden gaan uit van het volgende:

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;

Voorbeelden van functies
Voorbeeld	Resultaat
weekname('01/12/2013')	Retourneert 2013/02.
weekname('01/12/2013', -1)	Returns 2013/01.
weekname('01/12/2013', 0, 1)	Retourneert 2013/02.

Voorbeeld 1 – datum zonder 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 gegevensset met een set transacties voor de laatste week van 2021 en eerste twee weken van 2022 wordt geladen in een tabel met de naam 'Transactions'.
De systeemvariabele DateFormat die is ingesteld op de indeling MM/DD/YYYY.
De systeemvariabele BrokenWeeks die is ingesteld op 1.
De systeemvariabele FirstWeekDay die is ingesteld op 6.
Een voorgaande lading die het volgende bevat:
- De functie weekday() die is ingesteld als het veld, 'week_number', dat het jaar- en weeknummer retourneert wanneer de transacties plaatsvonden.
- De functie weekname() die is ingesteld als het veld met de naam 'week_day', om de weekdagwaarde van elke transactiedatum weer te geven.

Load-script


SET BrokenWeeks=1; 
SET DateFormat='MM/DD/YYYY'; 
SET FirstWeekDay=6; 

Transactions: 
   Load 
     *, 
     WeekDay(date) as week_day, 
     Weekname(date) as week_number 
     ; 
Load 
* 
Inline  
[ 
id,date,amount 
8183,12/27/2021,58.27 
8184,12/28/2021,67.42 
8185,12/29/2021,23.80 
8186,12/30/2021,82.06 
8187,12/31/2021,40.56 
8188,01/01/2022,37.23 
8189,01/02/2022,17.17 
8190,01/03/2022,88.27 
8191,01/04/2022,57.42 
8192,01/05/2022,53.80 
8193,01/06/2022,82.06 
8194,01/07/2022,40.56 
8195,01/08/2022,53.67 
8196,01/09/2022,26.63 
8197,01/10/2022,72.48 
8198,01/11/2022,18.37 
8199,01/12/2022,45.26 
8200,01/13/2022,58.23 
8201,01/14/2022,18.52 
];

Resultaten

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

id
date
week_day
week_number

Resultatentabel
id	date	week_day	week_number
8183	12/27/2021	Ma	2021/53
8184	12/28/2021	Di	2021/53
8185	12/29/2021	Wo	2021/53
8186	12/30/2021	Do	2021/53
8187	12/31/2021	Vr	2021/53
8188	01/01/2022	Za	2022/01
8189	01/02/2022	Zo	2022/02
8190	01/03/2022	Ma	2022/02
8191	01/04/2022	Di	2022/02
8192	01/05/2022	Wo	2022/02
8193	01/06/2022	Do	2022/02
8194	01/07/2022	Vr	2022/02
8195	01/08/2022	Za	2022/02
8196	01/09/2022	Zo	2022/03
8197	01/10/2022	Ma	2022/03
8198	01/11/2022	Di	2022/03
8199	01/12/2022	Wo	2022/03
8200	01/13/2022	Do	2022/03
8201	01/14/2022	Vr	2022/03

Het veld 'week_number' wordt gemaakt in de voorafgaande load-instructie met behulp van de functie weekname() en geeft het datumveld door als het argument van de functie.

De functie weekname() identificeert aanvankelijk in welke week de datumwaarde valt en retourneert het aantal weeknummers en het jaar waarin de transactie plaatsvindt.

De systeemvariabele FirstWeekDay stelt zondag in als de eerste dag van de week. De systeemvariabele BrokenWeeks stelt de toepassing in op het gebruik van gebroken weken, wat betekent dat week 1 op 1 januari begint.

Diagram dat laat zien hoe de functie weekname() het weeknummer en jaar identificeert waarin een transactie plaatsvindt. — Diagram van de functie weekname() met de standaardvariabelen.

Week 1 begint op 1 januari, wat een zaterdag is, en daarom retourneren transacties die op deze datum plaatsvinden de waarde 2022/01 (het jaar- en weeknummer).

Diagram dat laat zien hoe de functie weekname() het weeknummer identificeert waarin een transactie 8192 plaatsvond. — Diagram van de functie weekname() die het weeknummer van transactie 8192 identificeert.

Omdat de toepassing gebroken weken gebruikt en de eerste weekdag zondag is, retourneren transacties die plaatsvinden van 2 januari tot 8 januari de waarde 2022/02 (weeknummer 2 in 2022). Een voorbeeld hiervan is transactie 8192 die plaatsvond op 5 januari en de waarde 2022/02 retourneert voor het veld 'week_number'.

Voorbeeld 2 – period_no

Overzicht

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

In dit voorbeeld is het echter de taak om een veld te maken, 'previous_week_number', dat het jaar en het weeknummer retourneert voordat de transacties plaatsvonden.

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

Load-script

SET BrokenWeeks=1; 
SET FirstWeekDay=6; 
						
Transactions: 
   Load 
     *, 
     weekname(date,-1) as previous_week_number 
     ; 
Load 
* 
Inline  
[ 
id,date,amount 
8183,12/27/2021,58.27 
8184,12/28/2021,67.42 
8185,12/29/2021,23.80 
8186,12/30/2021,82.06 
8187,12/31/2021,40.56 
8188,01/01/2022,37.23 
8189,01/02/2022,17.17 
8190,01/03/2022,88.27 
8191,01/04/2022,57.42 
8192,01/05/2022,53.80 
8193,01/06/2022,82.06 
8194,01/07/2022,40.56 
8195,01/08/2022,53.67 
8196,01/09/2022,26.63 
8197,01/10/2022,72.48 
8198,01/11/2022,18.37 
8199,01/12/2022,45.26 
8200,01/13/2022,58.23 
8201,01/14/2022,18.52 
];

Resultaten

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

id
date
week_day
week_number

Resultatentabel
id	date	week_day	week_number
8183	12/27/2021	Ma	2021/52
8184	12/28/2021	Di	2021/52
8185	12/29/2021	Wo	2021/52
8186	12/30/2021	Do	2021/52
8187	12/31/2021	Vr	2021/52
8188	01/01/2022	Za	2021/52
8189	01/02/2022	Zo	2021/53
8190	01/03/2022	Ma	2021/53
8191	01/04/2022	Di	2021/53
8192	01/05/2022	Wo	2021/53
8193	01/06/2022	Do	2021/53
8194	01/07/2022	Vr	2021/53
8195	01/08/2022	Za	2022/01
8196	01/09/2022	Zo	2022/02
8197	01/10/2022	Ma	2022/02
8198	01/11/2022	Di	2022/02
8199	01/12/2022	Wo	2022/02
8200	01/13/2022	Do	2022/02
8201	01/14/2022	Vr	2022/02

Omdat een period_no van -1 werd gebruikt als het offset-argument in de functie weekname(), identificeert de functie eerst de week waarin de transacties plaatsvinden. Het kijkt dan een week eerder en identificeert de eerste milliseconde van die week.

Diagram dat laat zien hoe de offset period_no van min één zorgt ervoor dat de functie weekname() het weeknummer van de vorige week ophaalt. — Diagram van functie weekname() met een offset period_no van -1.

Transactie 8192 vond plaats op 5 januari 2022. De functie weekname() kijkt een week eerder, 30 december 2021, en retourneert het weeknummer en het jaar voor die datum – 2021/53.

Voorbeeld 3 – first_week_day

Overzicht

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

In dit voorbeeld is het bedrijfsbeleid echter dat de werkweek op dinsdag begint.

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

Load-script

SET BrokenWeeks=1; 
SET DateFormat='MM/DD/YYYY'; 

Transactions: 
   Load 
     *, 
     weekday(date) as week_day, 
     weekname(date,0,1) as week_number 
     ; 
Load 
* 
Inline  
[ 
id,date,amount 
8183,12/27/2021,58.27 
8184,12/28/2021,67.42 
8185,12/29/2021,23.80 
8186,12/30/2021,82.06 
8187,12/31/2021,40.56 
8188,01/01/2022,37.23 
8189,01/02/2022,17.17 
8190,01/03/2022,88.27 
8191,01/04/2022,57.42 
8192,01/05/2022,53.80 
8193,01/06/2022,82.06 
8194,01/07/2022,40.56 
8195,01/08/2022,53.67 
8196,01/09/2022,26.63 
8197,01/10/2022,72.48 
8198,01/11/2022,18.37 
8199,01/12/2022,45.26 
8200,01/13/2022,58.23 
8201,01/14/2022,18.52 
];

Resultaten

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

id
date
week_day
week_number

Resultatentabel
id	date	week_day	week_number
8183	12/27/2021	Ma	2021/52
8184	12/28/2021	Di	2021/53
8185	12/29/2021	Wo	2021/53
8186	12/30/2021	Do	2021/53
8187	12/31/2021	Vr	2021/53
8188	01/01/2022	Za	2022/01
8189	01/02/2022	Zo	2022/01
8190	01/03/2022	Ma	2022/01
8191	01/04/2022	Di	2022/02
8192	01/05/2022	Wo	2022/02
8193	01/06/2022	Do	2022/02
8194	01/07/2022	Vr	2022/02
8195	01/08/2022	Za	2022/02
8196	01/09/2022	Zo	2022/02
8197	01/10/2022	Ma	2022/02
8198	01/11/2022	Di	2022/03
8199	01/12/2022	Wo	2022/03
8200	01/13/2022	Do	2022/03
8201	01/14/2022	Vr	2022/03

Diagram dat laat zien hoe de functie weekname() werkt wanneer dinsdag is ingesteld als de eerste dag van de week. — Diagram van functie weekname() met dinsdag als de eerste dag van de week.

Omdat het argument first_week_date van 1 wordt gebruikt in de functie weekname(), wordt dinsdag als eerste dag van de week gebruikt. De functie bepaalt dus dat week 53 van 2021 begint op dinsdag 28 december; en vanwege de toepassing met gebroken weken begint week 1 op 1 januari 2022 en eindigt op de laatste milliseconde van maandag 3 januari 2022.

Diagram dat laat zien hoe het instellen van dinsdag als de eerste dag van de week ervoor zorgt dat de functie weekname() een ander weeknummer retourneert voor transactie 8192. — Diagram met weeknummer van transactie 8192 met dinsdag als eerste dag van de week.

Transactie 8192 vond plaats op 5 januari 2022. Daarom, met behulp van een parameter first_week_day van dinsdag, retourneert de functie weekname() de waarde 2022/02 voor het veld 'week_number'.

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 het jaarnummer van de week retourneert maand waarin de transacties plaatsvonden is gemaakt als meting in een diagramobject van de toepassing.

Load-script

SET BrokenWeeks=1; 
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8183,12/27/2021,58.27 
8184,12/28/2021,67.42 
8185,12/29/2021,23.80 
8186,12/30/2021,82.06 
8187,12/31/2021,40.56 
8188,01/01/2022,37.23 
8189,01/02/2022,17.17 
8190,01/03/2022,88.27 
8191,01/04/2022,57.42 
8192,01/05/2022,53.80 
8193,01/06/2022,82.06 
8194,01/07/2022,40.56 
8195,01/08/2022,53.67 
8196,01/09/2022,26.63 
8197,01/10/2022,72.48 
8198,01/11/2022,18.37 
8199,01/12/2022,45.26 
8200,01/13/2022,58.23 
8201,01/14/2022,18.52 
];

Resultaten

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

id
date
=week_day (date)

Maak de volgende meting om de start van de week waarin een transactie plaatsvindt te berekenen:

=weekname(date)

Resultatentabel
id	date	=weekday(date)	=weekname(date)
8183	12/27/2021	Ma	2021/53
8184	12/28/2021	Di	2021/53
8185	12/29/2021	Wo	2021/53
8186	12/30/2021	Do	2021/53
8187	12/31/2021	Vr	2021/53
8188	01/01/2022	Za	2022/01
8189	01/02/2022	Zo	2022/02
8190	01/03/2022	Ma	2022/02
8191	01/04/2022	Di	2022/02
8192	01/05/2022	Wo	2022/02
8193	01/06/2022	Do	2022/02
8194	01/07/2022	Vr	2022/02
8195	01/08/2022	Za	2022/02
8196	01/09/2022	Zo	2022/03
8197	01/10/2022	Ma	2022/03
8198	01/11/2022	Di	2022/03
8199	01/12/2022	Wo	2022/03
8200	01/13/2022	Do	2022/03
8201	01/14/2022	Vr	2022/03

Het veld ‘week_number’ wordt gemaakt als een meting in het diagramobject door de functie weekname() te gebruiken en het datumveld door te geven als het argument van de functie.

De functie weekname() identificeert aanvankelijk in welke week de datumwaarde valt en retourneert het aantal weeknummers en het jaar waarin de transactie plaatsvindt.

Diagram dat laat zien dat week 1 begint op 1 januari en zondag als de eerste dag van de week. — Diagram met weeknummer met zondag als eerste dag van de week.

Diagram met transactie 8192 vindt plaats in week 2. — Diagram waarop te zien is dat transactie 8192 in week nummer twee heeft plaatsgevonden.

Omdat de toepassing gebroken weken gebruikt en de eerste weekdag zondag is, retourneren transacties die plaatsvinden van 2 januari tot 8 januari de waarde 2022/02, weeknummer 2 in 2022. Transactie 8192 vond plaats op 5 januari en de waarde retourneert 2022/02 voor het veld 'week_number'.

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 met een set transacties voor de laatste week van 2019 en eerste twee weken van 2020 wordt geladen in een tabel met de naam 'Transactions'.
De systeemvariabele BrokenWeeks die is ingesteld op 0.
De systeemvariabele ReferenceDay die is ingesteld op 2.
De systeemvariabele DateFormat die is ingesteld op de indeling MM/DD/YYYY.

Load-script

SET BrokenWeeks=0;  
SET ReferenceDay=2;  
SET DateFormat='MM/DD/YYYY'; 

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8183,12/27/2019,58.27 
8184,12/28/2019,67.42 
8185,12/29/2019,23.80 
8186,12/30/2019,82.06 
8187,12/31/2019,40.56 
8188,01/01/2020,37.23 
8189,01/02/2020,17.17 
8190,01/03/2020,88.27 
8191,01/04/2020,57.42 
8192,01/05/2020,53.80 
8193,01/06/2020,82.06 
8194,01/07/2020,40.56 
8195,01/08/2020,53.67 
8196,01/09/2020,26.63 
8197,01/10/2020,72.48 
8198,01/11/2020,18.37 
8199,01/12/2020,45.26 
8200,01/13/2020,58.23 
8201,01/14/2020,18.52 
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel.

Maak een berekende dimensie met behulp van de volgende uitdrukking:

=weekname(date)

Maak de volgende aggregatiemeting om de totale verkoop te berekenen:

=sum(amount)

Stel de Getalnotatie van de meting in op Geld.

Resultatentabel
weekname(date)	=sum(amount)
2019/52	$125.69
2020/01	$346.51
2020/02	$347.57
2020/03	$122.01

Om de resultaten van het gebruik van de functie weekname() in dit scenario te demonstreren, voegt u het volgende veld toe als een dimensie:

date

Resultatentabel met datumveld
weekname(date)	date	=sum(amount)
2019/52	12/27/2019	$58.27
2019/52	12/28/2019	$67.42
2020/01	12/29/2019	$23.80
2020/01	12/30/2019	$82.06
2020/01	12/31/2019	$40.56
2020/01	01/01/2020	$37.23
2020/01	01/02/2020	$17.17
2020/01	01/03/2020	$88.27
2020/01	01/04/2020	$57.42
2020/02	01/05/2020	$53.80
2020/02	01/06/2020	$82.06
2020/02	01/07/2020	$40.56
2020/02	01/08/2020	$53.67
2020/02	01/09/2020	$26.63
2020/02	01/10/2020	$72.48
2020/02	01/11/2020	$18.37
2020/03	01/12/2020	$45.26
2020/03	01/13/2020	$58.23
2020/03	01/14/2020	$18.52

Omdat de toepassing ononderbroken weken gebruikt en week 1 minimaal twee dagen in januari vereist vanwege de systeemvariabele ReferenceDay, bevat week 1 van 2020 transacties vanaf 29 december 2019.

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