Ga naar hoofdinhoud Ga naar aanvullende inhoud

weekyear - script- en diagramfunctie

Deze functie retourneert het jaar waarbij het weeknummer hoort, op basis van de omgevingsvariabelen. Het weeknummer varieert van 1 tot ongeveer 52.

Syntaxis:  

weekyear(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Retourgegevenstypen: geheel getal

Argumenten
Argument Beschrijving
timestamp De te evalueren datum of tijdstempel.
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

De weekyear()-functie bepaalt welke week van een jaar de datum in valt. Hij retourneert vervolgens het jaar dat bij dat weeknummer hoort.

Als BrokenWeeks is ingesteld op 0 (onwaar), weekyear() retourneert hetzelfde als year().

Diagram van het bereik van de weekyear()-functie

Diagram dat de tijdsperiode toont dat de weekyear()-functie evalueert.

Maar als de BrokenWeeks-systeemvariabele is ingesteld op gebruik van niet-opgesplitste weken, mag week 1 alleen een bepaald aantal dagen in januari omvatten op basis van de waarde die is gespecificeerd in de ReferenceDay-systeemvariabele.

Als bijvoorbeeld een ReferenceDay-waarde van 4 wordt gebruikt, moet week 1 ten minste vier dagen in januari omvatten. Het is mogelijk dat week 1 datums in december van het voorgaande jaar bevat of dat het laatste weeknummer van een jaar datums in januari van het volgende jaar bevat. In situaties zoals deze, retourneert de weekyear()-functie een andere waarde dan de year()-functie.

Diagram van het bereik van de weekyear()-functie bij gebruik van niet-opgesplitste weken

Diagram van hoe de weekyear()-functie werkt met niet-opgesplitste weken.

De weekyear()-functie is handig als u aggregaties per jaar wilt vergelijken. Bijvoorbeeld als u de totale verkoop van producten per jaar wilt zien. De weekyear()-functie wordt verkozen boven de year()-functie wanneer de gebruiker consistent wil blijven met de BrokenWeeks-systeemvariabele in de app.

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
weekyear('12/30/1996',0,0,4) Retourneert 1997, omdat week 1 van 1997 begint op 12/30/1996
weekyear('01/02/1997',0,0,4) retourneert 1997
weekyear('12/28/1997',0,0,4) retourneert 1997
weekyear('12/30/1997',0,0,4) Retourneert 1998, omdat week 1 van 1998 begint op 12/29/1997
weekyear('01/02/1999',0,0,4) Retourneert 1998, omdat week 53 van 1998 eindigt op 01/03/1999
Gerelateerde onderwerpen
Onderwerp Interactie
week - script- en diagramfunctie Retourneert een geheel getal dat het weeknummer representeert conform ISO 8601
year - script- en diagramfunctie Retourneert een geheel getal dat het jaar representeert als de uitdrukking wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.

Voorbeeld 1 - Opgesplitste weken

Voorbeeld 2 - Niet-opgesplitste weken

Voorbeeld 3 - Diagramobjectvoorbeeld

Voorbeeld 4 - Scenario

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!