quarterend - Skript- und Diagrammfunktion

Diese Funktion liefert den Zeitstempel der letzten Millisekunde des Quartals, in dem date liegt. Das Ergebnis wird entsprechend dem im Skript definierten DateFormat formatiert.

Syntax:

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

Rückgabe Datentyp: dual

Das Diagramm zeigt, wie die Funktion „quarterend()“ das Quartal identifiziert, in das ein Datum fällt, und dass der letzte Tag dieses Quartals zurückgegeben wird. — Diagramm der Funktion quarterend()

Die Funktion quarterend() bestimmt, in welches Quartal das Datum fällt. Sie gibt dann einen Zeitstempel im Datumsformat für die letzte Millisekunde des letzten Monats in diesem Quartal zurück. Der erste Monat des Jahres ist standardmäßig der Januar. Sie können aber ändern, welcher Monat als erster festgelegt wird, indem Sie das Argument first_month_of_year in der Funktion quarterend() verwenden.

Die Funktion quarterend() berücksichtigt die Systemvariable FirstMonthOfYear nicht. Das Jahr beginnt am 1. Januar, es sei denn, das Argument first_month_of_year wird verwendet, um dies zu ändern.

Verwendung

Die Funktion quarterend() wird oft als Teil einer Formel verwendet, wenn in der Berechnung der Teil des Quartals verwendet werden soll, der noch nicht eingetreten ist. Beispiel: Sie möchten die gesamten, während des Quartals noch nicht fällig gewordenen Zinsen berechnen.

Argumente
Argument	Beschreibung
date	Datum oder Zeitstempel für die Evaluierung.
period_no	period_no ist eine ganze Zahl, wobei 0 für das Quartal steht, das date enthält. Negative Werte von period_no stehen für vorangehende, positive Werte für nachfolgende Quartale.
first_month_of_year	Wenn Sie mit abweichenden Geschäftsjahren arbeiten möchten, definieren Sie mit einer Zahl zwischen 2 und 12 für first_month_of_year einen anderen Startmonat.

Sie können die folgenden Werte verwenden, um den ersten Monat des Jahres im Argument first_month_of_year festzulegen.

Werte für first_month_of_year
Monat	Wert
Februar	2
März	3
April	4
Mai	5
Juni	6
Juli	7
August	8
September	9
Oktober	10
November	11
Dezember	12

Regionaleinstellungen

Sofern nicht anders angegeben, verwenden die Beispiele in diesem Thema das folgende Datumsformat: MM/TT/JJJJ. Das Datumsformat wird in der Anweisung SET DateFormat in Ihrem Datenladeskript angegeben. Das Standarddatumsformat in Ihrem System kann aufgrund Ihrer regionalen Einstellungen und anderer Faktoren abweichen. Sie können die Formate in den Beispielen unten Ihren Anforderungen entsprechend ändern. Sie können auch die Formate in Ihrem Ladeskript entsprechend den Beispielen ändern. Weitere Informationen finden Sie unter Ändern von regionalen Einstellungen für Apps und Skripte.

Regionale Standardeinstellungen in Apps basieren auf dem Benutzerprofil. Diese Einstellungen im regionalen Format hängen nicht mit der Sprache zusammen, die in der Benutzeroberfläche von Qlik Cloud angezeigt wird. Qlik Cloud wird in der gleichen Sprache wie der von Ihnen verwendete Browser angezeigt.

Wenn Sie App-Ersteller sind, können Sie die Standardregion für die von Ihnen erstellte App festlegen. Weitere Informationen finden Sie unter Festlegen der bevorzugten regionalen Einstellungen für die App-und Skripterstellung in Qlik Cloud Analytics.

Funktionsbeispiele
Beispiel	Ergebnis
quarterend('10/29/2005')	Gibt 12/31/2005 23:59:59 zurück.
quarterend('10/29/2005', -1)	Gibt 09/30/2005 23:59:59 zurück.
quarterend('10/29/2005', 0, 3)	Gibt 11/30/2005 23:59:59 zurück.

Beispiel 1 – einfaches Beispiel

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript umfasst:

Ein Datensatz enthält eine Reihe von Transaktionen für 2022 und wird in eine Tabelle namens „Transactions“ geladen.
Ein vorangehender load-Befehl, der Folgendes enthält:
- Die Funktion quarterend(), die als das Feld „end_of_quarter“ festgelegt ist und einen Zeitstempel für das Ende des Quartals zurückgibt, in dem die Transaktionen stattfanden.
- Die Funktion timestamp(), die als das Feld „end_of_quarter_timestamp“ festgelegt ist und den genauen Zeitstempel für das Ende des ausgewählten Quartals zurückgibt.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date) as end_of_quarter, 
       timestamp(quarterend(date)) as end_of_quarter_timestamp 
       ; 
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 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

id
date
end_of_quarter
end_of_quarter_timestamp

Ergebnistabelle
id	date	end_of_quarter	end_of_quarter_timestamp
8188	1/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8189	1/19/2022	03/31/2022	3/31/2022 11:59:59 PM
8190	2/5/2022	03/31/2022	3/31/2022 11:59:59 PM
8191	2/28/2022	03/31/2022	3/31/2022 11:59:59 PM
8192	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8193	4/1/2022	06/30/2022	6/30/2022 11:59:59 PM
8194	5/7/2022	06/30/2022	6/30/2022 11:59:59 PM
8195	5/16/2022	06/30/2022	6/30/2022 11:59:59 PM
8196	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8197	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8198	7/9/2022	09/30/2022	9/30/2022 11:59:59 PM
8199	7/22/2022	09/30/2022	9/30/2022 11:59:59 PM
8200	7/23/2022	09/30/2022	9/30/2022 11:59:59 PM
8201	7/27/2022	09/30/2022	9/30/2022 11:59:59 PM
8202	8/2/2022	09/30/2022	9/30/2022 11:59:59 PM
8203	8/8/2022	09/30/2022	9/30/2022 11:59:59 PM
8204	8/19/2022	09/30/2022	9/30/2022 11:59:59 PM
8205	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8206	10/14/2022	12/31/2022	12/31/2022 11:59:59 PM
8207	10/29/2022	12/31/2022	12/31/2022 11:59:59 PM

Das Feld „end_of_quarter“ wird in der vorangehenden load-Anweisung erstellt, indem die Funktion quarterend() verwendet und das Datumsfeld als Argument der Funktion übergeben wird.

Die Funktion quarterend() identifiziert zuerst, in welches Quartal der Datumswert fällt, und gibt dann einen Zeitstempel für die letzte Millisekunde dieses Quartals zurück.

Das Diagramm zeigt das Ende des Quartals, das von der Funktion „quarterend()“ anhand des Transaktionsdatums von Transaktion 8203 identifiziert wird. — Diagramm der Funktion quarterend(), in dem das Quartalsende für Transaktion 8203 identifiziert ist

Transaktion 8203 fand am 8. August statt. Die Funktion quarterend() identifiziert, dass die Transaktion im dritten Quartal stattfand und gibt die letzte Millisekunde dieses Quartals zurück. Dies ist der 30. September um 11:59:59 PM.

Beispiel 2 – period_no

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript umfasst:

Datensatz mit einer Reihe von Transaktionen für 2022, der in eine Tabelle namens „Transactions“ geladen wird
Eine vorangehende load-Anweisung, die Folgendes enthält:
- Die Funktion quarterend(), die als das Feld „previous_quarter_end“ festgelegt ist und einen Zeitstempel für das Ende des Quartals vor dem Quartal zurückgibt, in dem die Transaktion stattfand.
- Die Funktion timestamp(), die als das Feld „previous_end_of_quarter_timestamp“ festgelegt ist und den genauen Zeitstempel für das Ende des Quartals vor dem Quartal zurückgibt, in dem die Transaktion stattfand.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date, -1) as previous_quarter_end, 
       timestamp(quarterend(date, -1)) as previous_quarter_end_timestamp 
       ; 
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 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

id
date
previous_quarter_end
previous_quarter_end_timestamp

Ergebnistabelle
id	date	previous_quarter_end	previous_quarter_end_timestamp
8188	1/7/2022	12/31/2021	12/31/2021 11:59:59 PM
8189	1/19/2022	12/31/2021	12/31/2021 11:59:59 PM
8190	2/5/2022	12/31/2021	12/31/2021 11:59:59 PM
8191	2/28/2022	12/31/2021	12/31/2021 11:59:59 PM
8192	3/16/2022	12/31/2021	12/31/2021 11:59:59 PM
8193	4/1/2022	03/31/2022	3/31/2022 11:59:59 PM
8194	5/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8195	5/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8196	6/15/2022	03/31/2022	3/31/2022 11:59:59 PM
8197	6/26/2022	03/31/2022	3/31/2022 11:59:59 PM
8198	7/9/2022	06/30/2022	6/30/2022 11:59:59 PM
8199	7/22/2022	06/30/2022	6/30/2022 11:59:59 PM
8200	7/23/2022	06/30/2022	6/30/2022 11:59:59 PM
8201	7/27/2022	06/30/2022	6/30/2022 11:59:59 PM
8202	8/2/2022	06/30/2022	6/30/2022 11:59:59 PM
8203	8/8/2022	06/30/2022	6/30/2022 11:59:59 PM
8204	8/19/2022	06/30/2022	6/30/2022 11:59:59 PM
8205	9/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8206	10/14/2022	09/30/2022	9/30/2022 11:59:59 PM
8207	10/29/2022	09/30/2022	9/30/2022 11:59:59 PM

Da eine period_no von -1 als Versatzargument in der Funktion quarterend() verwendet wird, identifiziert die Funktion zuerst das Quartal, in dem die Transaktionen stattfinden. Dann geht sie ein Quartal zurück und identifiziert die letzte Millisekunde dieses Quartals.

Transaktion 8203 fand am 8. August statt. Die Funktion quarterend() identifiziert, dass das Quartal vor dem Quartal, in dem die Transaktion stattfand, zwischen dem 1. April und 30. Juni lag. Die Funktion gibt dann die letzte Millisekunde für dieses Quartal zurück, den 30. Juni um 11:59:59 PM.

Beispiel 3 – first_month_of_year

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript umfasst:

Datensatz mit einer Reihe von Transaktionen für 2022, der in eine Tabelle namens „Transactions“ geladen wird
Eine vorangehende load-Anweisung, die Folgendes enthält:
- Die Funktion quarterend(), die als das Feld „end_of_quarter“ festgelegt ist und einen Zeitstempel für das Ende des Quartals zurückgibt, in dem die Transaktionen stattfanden.
- Die Funktion timestamp(), die als das Feld „end_of_quarter_timestamp“ festgelegt ist und den genauen Zeitstempel für das Ende des ausgewählten Quartals zurückgibt.

In diesem Beispiel legt die Unternehmensrichtlinie jedoch fest, dass das Geschäftsjahr am 1. März beginnt.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date, 0, 3) as end_of_quarter, 
       timestamp(quarterend(date, 0, 3)) as end_of_quarter_timestamp 
       ; 
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 
];

Ergebnisse

Ergebnistabelle
id	date	end_of_quarter	end_of_quarter_timestamp
8188	1/7/2022	02/28/2022	2/28/2022 11:59:59 PM
8189	1/19/2022	02/28/2022	2/28/2022 11:59:59 PM
8190	2/5/2022	02/28/2022	2/28/2022 11:59:59 PM
8191	2/28/2022	02/28/2022	2/28/2022 11:59:59 PM
8192	3/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8193	4/1/2022	05/31/2022	5/31/2022 11:59:59 PM
8194	5/7/2022	05/31/2022	5/31/2022 11:59:59 PM
8195	5/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8196	6/15/2022	08/31/2022	8/31/2022 11:59:59 PM
8197	6/26/2022	08/31/2022	8/31/2022 11:59:59 PM
8198	7/9/2022	08/31/2022	8/31/2022 11:59:59 PM
8199	7/22/2022	08/31/2022	8/31/2022 11:59:59 PM
8200	7/23/2022	08/31/2022	8/31/2022 11:59:59 PM
8201	7/27/2022	08/31/2022	8/31/2022 11:59:59 PM
8202	8/2/2022	08/31/2022	8/31/2022 11:59:59 PM
8203	8/8/2022	08/31/2022	8/31/2022 11:59:59 PM
8204	8/19/2022	08/31/2022	8/31/2022 11:59:59 PM
8205	9/26/2022	11/30/2022	11/30/2022 11:59:59 PM
8206	10/14/2022	11/30/2022	11/30/2022 11:59:59 PM
8207	10/29/2022	11/30/2022	11/30/2022 11:59:59 PM

Da das Argument first_month_of_year von 3 in der Funktion quarterend() verwendet wird, wird der Start des Jahres vom 1. Januar auf den 1. März verschoben.

Transaktion 8203 fand am 8. August statt. Da der Anfang des Jahres der 1. März ist, sind die Quartale des Jahres Mär-Mai, Jun-Aug, Sep-Nov und Dez-Feb.

Die Funktion quarterend() identifiziert, dass die Transaktion im Quartal zwischen Anfang Juni und Ende August stattfand und gibt die letzte Millisekunde dieses Quartals zurück. Dies ist der 31. August um 11:59:59 PM.

Beispiel 4 – Diagrammobjektbeispiel

Übersicht

Es werden derselbe Datensatz und dasselbe Szenario wie im ersten Beispiel verwendet.

In diesem Beispiel wird jedoch der unveränderte Datensatz in die Anwendung geladen. Die Berechnung, die einen Zeitstempel für das Ende des Quartals zurückgibt, in dem die Transaktionen stattfanden, wird als Kennzahl in einem Diagramm in der App erstellt.

Ladeskript

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 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

id
date

Um das Enddatum des Quartals zu berechnen, in dem eine Transaktion stattfindet, erstellen Sie die folgenden Kennzahlen:

=quarterend(date)
=timestamp(quarterend(date))

Ergebnistabelle
id	date	=quarterend(date)	=timestamp(quarterend(date))
8188	1/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8189	1/19/2022	03/31/2022	3/31/2022 11:59:59 PM
8190	2/5/2022	03/31/2022	3/31/2022 11:59:59 PM
8191	2/28/2022	03/31/2022	3/31/2022 11:59:59 PM
8192	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8193	4/1/2022	06/30/2022	6/30/2022 11:59:59 PM
8194	5/7/2022	06/30/2022	6/30/2022 11:59:59 PM
8195	5/16/2022	06/30/2022	6/30/2022 11:59:59 PM
8196	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8197	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8198	7/9/2022	09/30/2022	9/30/2022 11:59:59 PM
8199	7/22/2022	09/30/2022	9/30/2022 11:59:59 PM
8200	7/23/2022	09/30/2022	9/30/2022 11:59:59 PM
8201	7/27/2022	09/30/2022	9/30/2022 11:59:59 PM
8202	8/2/2022	09/30/2022	9/30/2022 11:59:59 PM
8203	8/8/2022	09/30/2022	9/30/2022 11:59:59 PM
8204	8/19/2022	09/30/2022	9/30/2022 11:59:59 PM
8205	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8206	10/14/2022	12/31/2022	12/31/2022 11:59:59 PM
8207	10/29/2022	12/31/2022	12/31/2022 11:59:59 PM

Das Feld „end_of_quarter“ wird in der vorangehenden load-Anweisung erstellt, indem die Funktion quarterend() verwendet und das Datumsfeld als Argument der Funktion übergeben wird.

Die Funktion quarterend() identifiziert zuerst, in welches Quartal der Datumswert fällt, und gibt dann einen Zeitstempel für die letzte Millisekunde dieses Quartals zurück.

Beispiel 5 – Szenario

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript umfasst:

Ein Datensatz wird in eine Tabelle namens „Employee_Expenses“ geladen. Die Tabelle enthält die folgenden Felder:
- Mitarbeiter-IDs
- Mitarbeiternamen
- Die durchschnittlichen täglichen Spesenanträge pro Mitarbeiter.

Der Endbenutzer möchte ein Diagrammobjekt, das nach Mitarbeiter-ID und Mitarbeitername die geschätzten Spesenanträge anzeigt, die für das restliche Quartal noch anfallen werden. Das Geschäftsjahr beginnt im Januar.

Ladeskript

Employee_Expenses: 
Load 
* 
Inline  
[ 
employee_id,employee_name,avg_daily_claim 
182,Mark, $15 
183,Deryck, $12.5  
184,Dexter, $12.5 
185,Sydney,$27 
186,Agatha,$18 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

employee_id
employee_name

Erstellen Sie die folgende Kennzahl, um die kumulierten Zinsen zu berechnen:

=(quarterend(today(1))-today(1))*avg_daily_claim

Legen Sie das Zahlenformat der Kennzahl auf Währung fest.

Ergebnistabelle
employee_id	employee_name	=(quarterend(today(1))-today(1))*avg_daily_claim
182	Mark	$480.00
183	Deryck	$400.00
184	Dexter	$400.00
185	Sydney	$864.00
186	Agatha	$576.00

Die Funktion quarterend() verwendet das aktuelle Datum als einziges Argument und gibt das Enddatum des aktuellen Monats zurück. Dann zieht sie das aktuelle Datum vom Jahresenddatum ab, und die Formel gibt die Anzahl der im Monat verbleibenden Tage zurück.

Dieser Wert wird dann mit den durchschnittlichen täglichen Spesenanträgen der einzelnen Mitarbeitern multipliziert, um den geschätzten Spesenbetrag pro Mitarbeiter für das verbleibende Quartal zu berechnen.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab