quartername - skript- och diagramfunktion

Denna funktion returnerar ett visningsvärde med kvartalets månader (formaterat enligt skriptvariabeln MonthNames) och år med ett underliggande numeriskt värde som motsvarar en tidsmarkör för den första millisekunden av kvartalets första dag.

Syntax:

QuarterName(date[, period_no[, first_month_of_year]])

Returnerad datatyp: dual

Exempeldiagram som visar hur quartername-funktionen konverterar ett inmatningsdatum till ett månadsintervall som ingår i det kvartal då datumet inträffar. — Diagram för funktionen quartername()

quartername()-funktionen bestämmer vilket kvartal datumet infaller. Därefter returnerar det ett värde som visar start- och slutmånaderna i detta kvartal samt året. Det underliggande numeriska värdet för detta resultat är den första millisekunden i kvartalet.

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 kvartal som innehåller date. Negativa värden i period_no anger föregående kvartal och positiva värden anger efterföljande kvartal.
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.

Användning

Funktionen quartername() är användbar när du vill jämföra sammanställningar efter kvartal. Till exempel om du vill se den totala försäljningen av produkter per kvartal.

Denna funktion kan skapas i laddningsskriptet för att skapa ett fält i en Master Calendar-tabell. Eller användas direkt i ett diagram som en beräknad dimension.

I de här exemplen används datumformatet MM/DD/ÅÅÅÅ. Datumformatet anges i SET DateFormat-satsen längst upp i dataladdningsskriptet. Ändra formatet i exemplen så att det passar dina krav.

Exempel på funktioner
Exempel	Resultat
quartername('10/29/2013')	Returnerar Oct-Dec 2013.
quartername('10/29/2013', -1)	Returnerar Jul-Sep 2013.
quartername('10/29/2013', 0, 3)	Returnerar Sep-Nov 2013.

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.

Standardregionalinställningar i appar baseras på de regionala systeminställningarna för datorn eller servern där Qlik Sense är installerad. Om Qlik Sense-servern du ansluter till är inställd på Sverige så kommer skriptredigeraren använda regionala inställningar för Sverige för datum, tid och valuta. Dessa regionala formatinställningar är inte relaterade till språket som visas i Qlik Sense användargränssnittet. Qlik Sense kommer att visas på samma språk som webbläsaren du använder.

Exempel 1 – Datum utan ytterligare argument

Översikt

Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik.

Laddningsskriptet innehåller:

En datauppsättning som innehåller transaktioner för 2022 som läses in i en tabell som heter Transactions.
Datumfältet tillhandahålls i formatet (ÅÅÅÅ-MM-DD) i systemvariabeln DateFormat.
Ett fält transaction_quarter skapas som returnerar kvartalet då transaktionerna ägde rum.

Lägg till din andra text här, efter behov, med listor mm.

Laddningsskript

SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];

Resultat

Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:

date
transaction_quarter

Resultattabell
date	transaction_quarter
1/7/2022	Jan-mars 2022
1/19/2022	Jan-mars 2022
2/5/2022	Jan-mars 2022
2/28/2022	Jan-mars 2022
3/16/2022	Jan-mars 2022
4/1/2022	Apr-jun 2022
5/7/2022	Apr-jun 2022
5/16/2022	Apr-jun 2022
6/15/2022	Apr-jun 2022
6/26/2022	Apr-jun 2022
7/9/2022	Jul-sep 2022
7/22/2022	Jul-sep 2022
7/23/2022	Jul-sep 2022
7/27/2022	Jul-sep 2022
8/2/2022	Jul-sep 2022
8/8/2022	Jul-sep 2022
8/19/2022	Jul-sep 2022
9/26/2022	Jul-sep 2022
10/14/2022	Okt-dec 2022
10/29/2022	Okt-dec 2022

transaction_quarter-fältet skapades i den föregående load-satsen genom att använda quartername()-funktionen och skicka datumfältet som funktionens argument.

quartername()-funktionen identifierar initialt under vilket kvartal datumvärdet infaller. Därefter returnerar det ett värde som visar start- och slutmånaderna i detta kvartal samt året.

Diagram som visar hur kvartalsnamnsfunktionen bestämmer månadsintervallet för det kvartal då en transaktion äger rum. — Diagram för quartername()-funktionen, exempel utan ytterligare argument

Transaktion 8203 ägde rum 8 augusti 2022. quartername()-funktionen identifierar att transaktionen ägde rum under det tredje kvartalet och returnerar därför jul-sep 2022. Månaderna visas i samma format som systemvariabeln MonthNames.

Exempel 2 – datum med argumentet period_no

Översikt

Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik.

Laddningsskriptet innehåller:

Samma datauppsättning och scenario som i det första exemplet.
Ett fält previous_quarter skapas som returnerar kvartalet innan transaktionerna ägde rum.

Laddningsskript

SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,-1) as previous_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];

Resultat

Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:

date
previous_quarter

Resultattabell
date	previous_quarter
1/7/2022	Okt-dec 2021
1/19/2022	Okt-dec 2021
2/5/2022	Okt-dec 2021
2/28/2022	Okt-dec 2021
3/16/2022	Okt-dec 2021
4/1/2022	Jan-mars 2022
5/7/2022	Jan-mars 2022
5/16/2022	Jan-mars 2022
6/15/2022	Jan-mars 2022
6/26/2022	Jan-mars 2022
7/9/2022	Apr-jun 2022
7/22/2022	Apr-jun 2022
7/23/2022	Apr-jun 2022
7/27/2022	Apr-jun 2022
8/2/2022	Apr-jun 2022
8/8/2022	Apr-jun 2022
8/19/2022	Apr-jun 2022
9/26/2022	Apr-jun 2022
10/14/2022	Jul-sep 2022
10/29/2022	Jul-sep 2022

I det här fallet, eftersom ett period_no på -1 användes som förskjutningsargument i quartername()-funktionen, identifierar funktionen först att transaktionerna ägde rum under det tredje kvartalet. Därefter skiftar den till närmast föregående kvartal och returnerar ett värde som visar start- och slutmånaderna i detta kvartal samt året.

Transaktion 8203 ägde rum 8 augusti. quartername()-funktionen identifierar att kvartalet innan transaktionen ägde rum var mellan 1 april och 30 juni. Därför returnerar den apr-jun 2022.

Exempel 3 – datum med argumentet first_week_day

Översikt

Öppna skriptredigeraren och lägg till laddningsskriptet nedan i en ny flik.

Laddningsskriptet innehåller samma datauppsättning och scenario som i det första exemplet. Men i det här exemplet måste vi ställa in 1 mars som den första månaden i räkenskapsåret.

Laddningsskript

SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,0,3) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];

Resultat

Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:

date
transaction_quarter

Resultattabell
date	transaction_quarter
1/7/2022	dec-feb 2021
1/19/2022	dec-feb 2021
2/5/2022	dec-feb 2021
2/28/2022	dec-feb 2021
3/16/2022	mar-maj 2022
4/1/2022	mar-maj 2022
5/7/2022	mar-maj 2022
5/16/2022	mar-maj 2022
6/15/2022	jun-aug 2022
6/26/2022	jun-aug 2022
7/9/2022	jun-aug 2022
7/22/2022	jun-aug 2022
7/23/2022	jun-aug 2022
7/27/2022	jun-aug 2022
8/2/2022	jun-aug 2022
8/8/2022	jun-aug 2022
8/19/2022	jun-aug 2022
9/26/2022	sep-nov 2022
10/14/2022	sep-nov 2022
10/29/2022	sep-nov 2022

Eftersom first_month_of_year-argumentet 3 används i quartername()-funktionen i det här fallet flyttas årets början från 1 januari till 1 mars. Därför separeras årets kvartal till mars-maj, juni-augusti, september-november och december-februari.

Transaktion 8203 ägde rum 8 augusti. quartername()-funktionen identifierar att transaktionen ägde rum under det andra kvartalet, mellan början av juni och slutet av augusti. Därför returnerar den jun-aug 2022.

Exampel 4 – Diagramobjektexempel

Översikt

Öppna skriptredigeraren och lägg till laddningsskriptet nedan i en ny flik.

Laddningsskriptet innehåller samma datauppsättning och scenario som i det första exemplet.

I det här exemplet har dock den oförändrade datauppsättningen skickats till programmet. Beräkningen som returnerar en tidsmarkör för slutet av kvartalet då transaktionerna ägde rum skapas som ett mått i ett diagramobjekt för programmet.

Laddningsskript

Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];

Resultat

Ladda data och öppna ett ark. Skapa en ny tabell och lägg till det här fältet som en dimension: date.

Skapa följande mått:

=quartername(date)

Resultattabell
date	=quartername(date)
1/7/2022	Jan-mars 2022
1/19/2022	Jan-mars 2022
2/5/2022	Jan-mars 2022
2/28/2022	Jan-mars 2022
3/16/2022	Jan-mars 2022
4/1/2022	Apr-jun 2022
5/7/2022	Apr-jun 2022
5/16/2022	Apr-jun 2022
6/15/2022	Apr-jun 2022
6/26/2022	Apr-jun 2022
7/9/2022	Jul-sep 2022
7/22/2022	Jul-sep 2022
7/23/2022	Jul-sep 2022
7/27/2022	Jul-sep 2022
8/2/2022	Jul-sep 2022
8/8/2022	Jul-sep 2022
8/19/2022	Jul-sep 2022
9/26/2022	Jul-sep 2022
10/14/2022	Okt-dec 2022
10/29/2022	Okt-dec 2022

transaction_quarter-måttet skapades i den föregående load-satsen genom att använda quartername()-funktionen och skicka date-fältet som funktionens argument.

quartername()-funktionen identifierar initialt under vilket kvartal datumvärdet infaller. Därefter returnerar det ett värde som visar start- och slutmånaderna i detta kvartal samt året.

Exempel 5 – Scenario

Översikt

Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik.

Laddningsskriptet innehåller:

En datauppsättning som innehåller transaktioner för 2022 som läses in i en tabell som heter Transactions.
Datumfältet tillhandahålls i formatet (ÅÅÅÅ-MM-DD) i systemvariabeln DateFormat.

Slutanvändaren vill ha ett diagramobjekt som visar den totala försäljningen per kvartal för transaktionerna. Detta kan uppnås även när denna dimension inte är tillgänglig i datamodellen, med hjälp av quartername()-funktionen som en beräknad dimension i diagrammet.

Laddningsskript

SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/7/2022',17.17
8189,'1/19/2022',37.23
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];

Resultat

Gör följande:

Ladda data och öppna ett ark. Skapa en ny tabell.
Skapa en beräknad dimension med följande uttryck:

=quartername(date)
Beräkna sedan total försäljning med hjälp av följande aggregeringsmått.

=sum(amount)
Ange måttens Nummerformatering till Pengar.

Resultattabell
=quartername(date)	=sum(amount)
Jul-sep 2022	$446.31
Apr-jun 2022	$351.48
Jan-mars 2022	$253.89
Okt-dec 2022	$163.91

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här