Gå till huvudinnehåll

yearend - skript- och diagramfunktion

Denna funktion returnerar ett värde som motsvarar en tidsmarkör med den sista millisekunden av den sista dagen i det år som innehåller date. Det förvalda utdataformatet blir det DateFormat som har definierats i skriptet.

Syntax:  

YearEnd( date[, period_no[, first_month_of_year = 1]])

Med andra ord bestämmer yearend()-funktionen vilket år datumet infaller. Den returnerar sedan en tidsstämpel, i datumformat, för den sista millisekunden av det året. Årets första månad är som standard januari. Du kan dock ändra vilken månad som anges som första månaden genom att använda first_month_of_year-argumentet i yearend()-funktionen.

Anteckning om information yearend()-funktionen tar inte hänsyn till systemvariabeln FirstMonthOfYear. Året börjar den 1 januari om inte first_month_of_year-argumentet används för att ändra det.

Diagram för yearend()-funktionen.

Diagram som visar hur funktionen yearend() identifierar ett datum och slutet på året då den äger rum.

yearend()-funktionen används som en del av ett uttryck när du vill att beräkningen ska använda den del av året som ännu inte har inträffat. Till exempel om du vill beräkna den totala ränta som ännu inte uppkommit under året.

Returnerad datatyp: dual

Argument
Argument Beskrivning
date Det datum eller den tidsmarkör som ska utvärderas.
period_no period_no är ett heltal, där värdet 0 anger det år som innehåller date. Negativa värden i period_no anger föregående år och positiva värden anger efterföljande år.
first_month_of_year Om du vill arbeta med (budget)år som inte börjar i januari kan du ange ett värde mellan 2 och 12 i first_month_of_year.

Du kan använda följande värden för att ställa in den första månaden på året i argumentet first_month_of_year:

first_month_of_year values
Månad Värde
februari 2
mars 3
april 4
Maj 5
juni 6
juli 7
augusti 8
september 9
oktober 10
november 11
december 12

Lokala inställningar

Om inget annat anges använder exemplen i detta ämne följande datumformat: MM/DD/ÅÅÅÅ. Datumformatet anges i SET DateFormat-satsen i datainläsningsskriptet. Förvald datumformatering kan vara annorlunda i ditt system, på grund av dina regionala inställningar och andra faktorer. Du kan ändra formaten i exemplen nedan så att det passar dina krav. Eller så kan du ändra formaten i ditt laddningsskript så att de matchar dessa exempel. Mer information finns i Ändra regioninställningar för appen.

Regionala standardinställningar i appar baseras på användarprofilen. Dessa regionala formatinställningar är inte relaterade till språket som visas i Qlik Cloud användargränssnittet. Qlik Cloud kommer att visas på samma språk som webbläsaren du använder.

Om du skapar appar, kan du ange standardregionen för de appar du skapar. Mer information finns här Ställa in önskade regioninställningar för appar som skapas.

Exempel på funktioner
Exempel Resultat
yearend('10/19/2001') Returns 12/31/2001 23:59:59.
yearend('10/19/2001', -1) Returns 12/31/2000 23:59:59.
yearend('10/19/2001', 0, 4) Returns 03/31/2002 23:59:59.

Exempel 1 – inga ytterligare argument

Exampel 2 – period_no

Exempel 3 – first_month_of_year

Exampel 4 – Diagramobjektexempel

Exempel 5 – Scenario