yearstart - skript- och diagramfunktion
Denna funktion returnerar en tidsmarkör som motsvarar starten av den första dagen i det år som innehåller date. Det förvalda utdataformatet blir det DateFormat som har definierats i skriptet.
Syntax:
YearStart(date[, period_no[, first_month_of_year]])
Med andra ord bestämmer yearstart()-funktionen vilket år datumet infaller. Den returnerar sedan en tidsstämpel, i datumformat, för den sista millisekunden av det året. Den första månaden för året ä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 yearstart()-funktionen.
Användning
yearstart()-funktionen används som en del av ett uttryck när du vill att beräkningen ska använda den del av året som hittills har förflutit. Till exempel om du vill beräkna den ränta som har ackumulerats under ett år hittills.
Returnerad datatyp: dual
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. |
Följande månader kan användas i first_month_of_year argument:
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 appar och skript.
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 att skapa appar och skript i Qlik Cloud-analys.
Exempel | Resultat |
---|---|
yearstart('10/19/2001') | Returns 01/01/2001 00:00:00. |
yearstart('10/19/2001',-1) | Returns 01/01/2000 00:00:00. |
yearstart('10/19/2001',0,4) | Returns 04/01/2001 00:00:00. |
Exempel 1 – Grundläggande exempel
Översikt
Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik.
Laddningsskriptet innehåller:
-
En datauppsättning som innehåller transaktioner mellan år 2020 och 2022 som läses in i en tabell som heter Transactions.
-
Datumfältet har tillhandahållits i MM/DD/YYYY-formatet med systemvariabeln DateFormat.
-
En föregående LOAD-sats som innehåller följande:
-
yearstart()-funktion som är inställd som year_start-fält.
-
Timestamp()-funktion som är inställd som year_start_timestamp-fält.
-
Laddningsskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearstart(date) as year_start,
timestamp(yearstart(date)) as year_start_timestamp
;
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
];
Resultat
Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:
-
id
-
date
-
year_start
-
year_start_timestamp
id | date | year_start | year_start_timestamp |
---|---|---|---|
8188 | 01/13/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8189 | 02/26/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8190 | 03/27/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8191 | 04/16/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8192 | 05/21/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8193 | 08/14/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8194 | 10/07/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8195 | 12/05/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8196 | 01/22/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8197 | 02/03/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8198 | 03/17/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8199 | 04/23/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8200 | 05/04/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8201 | 06/30/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8202 | 07/26/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8203 | 12/27/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8204 | 06/06/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8205 | 07/18/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8206 | 11/14/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8207 | 12/12/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
year_start-fältet skapades i den föregående load-satsen genom att använda yearstart()-funktionen och skicka datumfältet som funktionens argument.
yearstart()-funktionen identifierar initialt vilket år datumvärdet infaller och returnerar en tidsstämpel för den första millisekunden av det året.
Transaktion 8199 ägde rum den 23 april 2021. yearstart()-funktionen returnerar den sista millisekunden av det året, vilket är den 1 januari 12:00:00 AM.
Exampel 2 – period_no
Översikt
Samma datauppsättning och scenario som det första exemplet används.
Men i det här exemplet är uppgiften att skapa ett fält, previous_year_start, som returnerar tidsstämpel för startdatum för året innan det år då en transaktion ägde rum.
Laddningsskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearstart(date,-1) as previous_year_start,
timestamp(yearstart(date,-1)) as previous_year_start_timestamp
;
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
];
Resultat
Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:
-
id
-
date
-
previous_year_start
-
previous_ year_start_timestamp
id | date | previous_year_start | previous_year_start_timestamp |
---|---|---|---|
8188 | 01/13/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8189 | 02/26/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8190 | 03/27/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8191 | 04/16/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8192 | 05/21/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8193 | 08/14/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8194 | 10/07/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8195 | 12/05/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM |
8196 | 01/22/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8197 | 02/03/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8198 | 03/17/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8199 | 04/23/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8200 | 05/04/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8201 | 06/30/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8202 | 07/26/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8203 | 12/27/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8204 | 06/06/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8205 | 07/18/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8206 | 11/14/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8207 | 12/12/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM |
I det här fallet, eftersom ett period_no på -1 användes som förskjuningsargument i yearstart()-funktionen, identifierar funktionen först den månad då transaktionerna äger rum. Den tittar sedan ett år innan och identifierar den första millisekunden för det året.
Transaktion 8199 ägde rum den 23 april 2021. yearstart()-funktionen returnerar den första millisekunden av det föregående året, vilket är den 1 januari 2020 kl 12:00:00 för previous_year_start-fältet
Exempel 3 – first_month_of_year
Översikt
Samma datauppsättning och scenario som det första exemplet används.
Men i det här exemplet är företagets policy att året ska börja den 1 april.
Laddningsskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yearstart(date,0,4) as year_start,
timestamp(yearstart(date,0,4)) as year_start_timestamp
;
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
];
Resultat
Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:
-
id
-
date
-
year_start
-
year_start_timestamp
id | date | year_start | year_start_timestamp |
---|---|---|---|
8188 | 01/13/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM |
8189 | 02/26/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM |
8190 | 03/27/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM |
8191 | 04/16/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8192 | 05/21/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8193 | 08/14/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8194 | 10/07/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8195 | 12/05/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8196 | 01/22/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8197 | 02/03/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8198 | 03/17/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM |
8199 | 04/23/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM |
8200 | 05/04/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM |
8201 | 06/30/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM |
8202 | 07/26/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM |
8203 | 12/27/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM |
8204 | 06/06/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM |
8205 | 07/18/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM |
8206 | 11/14/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM |
8207 | 12/12/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM |
I det här fallet, eftersom first_month_of_year-argumentet för 4 används i yearstart()-funktionen, ställer det in årets första dag till 1 april och årets sista dag till 31 mars.
Transaktion 8199 ägde rum den 23 april 2021. Eftersom yearstart()-funktionen ställer in början av året till 1 april, returnerar den 31 mars 2022 som year_start-värdet för transaktionen.
Exampel 4 – Diagramobjektexempel
Översikt
Samma datauppsättning och scenario som det första exemplet används.
I det här exemplet är dock datauppsättningen oförändrad och har lästs in i programmet. Beräkningen som returnerar en tidsmarkör för startdatum för året då en transaktionen ägde rum skapas som ett mått i ett diagramobjekt för programmet.
Laddningsskript
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
];
Resultat
Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:
-
id
-
date
För att beräkna vilket år en transaktion ägde rum skapar du följande mått:
-
=yearstart(date)
-
=timestamp(yearstart(date))
id | date | =yearstart(date) | =timestamp(yearstart(date)) |
---|---|---|---|
8188 | 06/06/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8189 | 07/18/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8190 | 11/14/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8191 | 12/12/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM |
8192 | 01/22/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8193 | 02/03/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8194 | 03/17/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8195 | 04/23/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8196 | 05/04/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8197 | 06/30/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8198 | 07/26/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8199 | 12/27/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM |
8200 | 01/13/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8201 | 02/26/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8202 | 03/27/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8203 | 04/16/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8204 | 05/21/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8205 | 08/14/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8206 | 10/07/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
8207 | 12/05/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM |
start_of_year-måttet skapades i ett diagramobjektet genom att använda yearstart()-funktionen och skicka datumfältet som funktionens argument.
yearstart()-funktionen identifierar initialt vilket år datumvärdet infaller och returnerar en tidsstämpel för den första millisekunden av det året.
Transaktion 8199 ägde rum den 23 april 2021. yearstart()-funktionen returnerar den sista millisekunden av det året, vilket är den 1 januari 12:00:00 AM.
Exempel 5 – Scenario
Översikt
Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik.
Laddningsskriptet innehåller:
-
En datauppsättning läses in i en tabell som heter Loans. Tabellen innehåller följande fält:
-
Låne-ID:n.
-
Saldo i början av året.
-
Den enkla räntan som tas ut på varje lån per år.
-
Slutanvändaren vill ha ett diagramobjekt som visar, efter låne-id, den aktuella räntan som har ackumulerats för varje lån under året hittills.
Laddningsskript
Loans:
Load
*
Inline
[
loan_id,start_balance,rate
8188,$10000.00,0.024
8189,$15000.00,0.057
8190,$17500.00,0.024
8191,$21000.00,0.034
8192,$90000.00,0.084
];
Resultat
Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:
-
loan_id
-
start_balance
För att beräkna ackumulerad ränta skapar du följande mått:
=start_balance*(rate*(today(1)-yearstart(today(1)))/365)
Ange måttens Nummerformatering till Pengar.
loan_id | start_balance | =start_balance*(rate*(today(1)-yearstart(today(1)))/365) |
---|---|---|
8188 | $10000.00 | $39.73 |
8189 | $15000.00 | $339.66 |
8190 | $17500.00 | $166.85 |
8191 | $21000.00 | $283.64 |
8192 | $90000.00 | $3003.29 |
Genom att använda dagens datum som enda argument returnerar yearstart()-funktionen slutdatumet för det aktuella året. Genom att subtrahera resultatet från det aktuella datumet returnerar uttrycket antalet dagar som har förflutit hittills i år.
Detta värde multipliceras sedan med räntan och divideras med 365 för att returnera den effektiva räntan för perioden. Den effektiva räntan för perioden multipliceras sedan med lånets utgångssaldo för att återbetala den upplupna räntan hittills i år.