yearname - Skript- und Diagrammfunktion

Diese Funktion liefert den Zeitstempel der ersten Millisekunde des ersten Tages des Jahres, in dem date liegt. Das Ergebnis wird als vierstellige Jahreszahl formatiert.

Diagramm, das den Zeitraum anzeigt, in dem die Funktion „yearname“ ein Ergebnis zurückgibt. — Diagramm des Zeitraums der Funktion yearname().

Die Funktion yearname() unterscheidet sich von der Funktion year() dahingehend, dass sie einen Versatz des Datums ermöglicht, das ausgewertet werden soll. Außerdem kann der erste Monat des Jahres festgelegt werden.

Wenn der erste Monat des Jahres nicht Januar ist, gibt die Funktion die beiden vierstelligen Jahreszahlen über den Zwölfmonatszeitraum zurück, die das Datum enthalten. Wenn beispielsweise das Jahr im April beginnt und das ausgewertete Datum 06/30/2020 ist, wird als Ergebnis 2020-2021 zurückgegeben.

Diagramm, welches anzeigt, dass die Funktion „yearname“ Datumsangaben innerhalb eines Zwölfmonatszeitraums identifizieren kann und dass ihre Rückgabe davon abhängen kann, welcher Monat als erster Monat des Jahres festgelegt ist — Diagramm der Funktion yearname() mit April als erstem Monat des Jahres.

Syntax:

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

Rückgabe Datentyp: dual

Argument	Beschreibung
date	Datum oder Zeitstempel für die Evaluierung.
period_no	period_no ist eine ganze Zahl, wobei 0 für das Jahr steht, das date enthält. Negative Werte von period_no stehen für vorangehende, positive Werte für nachfolgende Jahre.
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. In diesem Fall besteht das Ergebnis aus zwei Jahreszahlen.

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

Verwendung

Die Funktion yearname() eignet sich für den Vergleich von Aggregierungen nach Jahr. Das ist beispielsweise der Fall, wenn Sie den Gesamtumsatz von Produkten nach Jahr anzeigen möchten.

Diese Dimensionen können im Ladeskript erstellt werden, indem die Funktion verwendet wird, um ein Feld in einer Master-Kalender-Tabelle zu erstellen. Sie können auch als berechnete Dimensionen in einem Diagramm erstellt werden.

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
yearname('10/19/2001')	Gibt „2001“ zurück.
yearname('10/19/2001',-1)	Gibt „2000“ zurück.
yearname('10/19/2001',0,4)	Gibt „2001-2002“ zurück.

Verwandte Themen
Thema	Beschreibung
year - Skript- und Diagrammfunktion	Diese Funktion liefert das Jahr als ganze Zahl, wenn die Formel entsprechend der Standardzahleninterpretation als Datum interpretiert wird.

Beispiel 1 – keine zusätzlichen Argumente

Übersicht

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

Das Ladeskript umfasst:

Ein Datensatz, der eine Reihe von Transaktionen zwischen 2020 und 2022 enthält, wird in eine Tabelle namens „Transactions“ geladen.
Die Systemvariable DateFormat, die auf „MM/DD/YYYY“ festgelegt ist.
Ein vorangehender load-Befehl, der die Funktion yearname() verwendet und als das Feld year_name festgelegt ist.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
      *, 
      yearname(date) as year_name 
      ; 
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 
];

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:

date
year_name

Ergebnistabelle
date	year_name
01/13/2020	2020
02/26/2020	2020
03/27/2020	2020
04/16/2020	2020
05/21/2020	2020
08/14/2020	2020
10/07/2020	2020
12/05/2020	2020
01/22/2021	2021
02/03/2021	2021
03/17/2021	2021
04/23/2021	2021
05/04/2021	2021
06/30/2021	2021
07/26/2021	2021
12/27/2021	2021
06/06/2022	2022
07/18/2022	2022
11/14/2022	2022
12/12/2022	2022

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

Die Funktion yearname() identifiziert, in welches Jahr der Datumswert fällt, und gibt dies als vierstelligen Jahreswert zurück.

Diagramm, das anzeigt, dass die Funktion „yearname()“ den Wert 2021 für das Datum 17. März 2021 zurückgibt — Diagramm der Funktion yearname(), die 2021 als den Jahreswert anzeigt

Beispiel 2 – period_no

Übersicht

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

Das Ladeskript umfasst:

Ein Datensatz, der eine Reihe von Transaktionen zwischen 2020 und 2022 enthält, wird in eine Tabelle namens „Transactions“ geladen.
Die Systemvariable „DateFormat“, die auf „MM/DD/YYYY“ festgelegt ist.
Eine vorangehende load-Anweisung, die die Funktion yearname() verwendet und als das Feld year_name festgelegt ist.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
      *, 
      yearname(date,-1) as prior_year_name 
      ; 
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 
];

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:

date
prior_year_name

Ergebnistabelle
date	prior_year_name
01/13/2020	2019
02/26/2020	2019
03/27/2020	2019
04/16/2020	2019
05/21/2020	2019
08/14/2020	2019
10/07/2020	2019
12/05/2020	2019
01/22/2021	2020
02/03/2021	2020
03/17/2021	2020
04/23/2021	2020
05/04/2021	2020
06/30/2021	2020
07/26/2021	2020
12/27/2021	2020
06/06/2022	2021
07/18/2022	2021
11/14/2022	2021
12/12/2022	2021

Da eine period_no von -1 als Versatzargument in der Funktion yearname() verwendet wird, identifiziert die Funktion zuerst das Jahr, in dem die Transaktionen stattfinden. Die Funktion wechselt dann zum vorherigen Jahr und gibt dieses Jahr als Ergebnis zurück.

Diagramm, das anzeigt, wie eine „period_no“ von minus eins die Zeiträume ändert, die von der Funktion „yearname()“ identifiziert werden — Diagramm der Funktion yearname(), bei der period_no als -1 festgelegt ist

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:

Den gleichen Datensatz wie im ersten Beispiel.
Die Systemvariable DateFormat, die auf „MM/DD/YYYY“ festgelegt ist.
Eine vorangehende load-Anweisung, die die Funktion yearname() verwendet und als das Feld year_name festgelegt ist.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
      *, 
      yearname(date,0,4) as year_name 
      ; 
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 
];

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
year_name

Ergebnistabelle
date	year_name
01/13/2020	2019-2020
02/26/2020	2019-2020
03/27/2020	2019-2020
04/16/2020	2020-2021
05/21/2020	2020-2021
08/14/2020	2020-2021
10/07/2020	2020-2021
12/05/2020	2020-2021
01/22/2021	2020-2021
02/03/2021	2020-2021
03/17/2021	2020-2021
04/23/2021	2021-2022
05/04/2021	2021-2022
06/30/2021	2021-2022
07/26/2021	2021-2022
12/27/2021	2021-2022
06/06/2022	2022-2023
07/18/2022	2022-2023
11/14/2022	2022-2023
12/12/2022	2022-2023

Da das Argument first_month_of_year von 4 in der Funktion yearname() verwendet wird, verschiebt sich der Jahresbeginn vom 1. Januar zum 1. April. Daher liegt jeder Zwölfmonatszeitraum zwischen zwei Kalenderjahren, und die Funktion yearname() gibt zwei vierstellige Jahreszahlen für jedes ausgewertete Datum zurück.

Transaktion 8198 findet am 17. März 2021 statt. Die Funktion yearname() legt den Jahresbeginn auf den 1. April und das Jahresende auf den 30. März fest. Infolgedessen fand die Transaktion 8198 im Jahreszeitraum vom 1. April 2020 bis zum 30. März 2021 statt. Somit gibt die Funktion yearname() den Wert 2020-2021 zurück.

Diagramm mit dem Zeitraum, den die Funktion „yearname()“ identifiziert, wenn der erste Monat des Jahres als März festgelegt ist — Diagramm der Funktion yearname() mit März als erstem Monat des Jahres

Beispiel 4 – Diagrammobjektbeispiel

Übersicht

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

Das Ladeskript umfasst:

Den gleichen Datensatz wie im ersten Beispiel.
Die Systemvariable DateFormat, die auf „MM/DD/YYYY“ festgelegt ist.

Das Feld, das das Jahr zurückgibt, in dem die Transaktion stattfand, wird jedoch als Kennzahl in einem Diagrammobjekt erstellt.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 
						
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 
];

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu:

date

Um das Feld „year_name“ zu berechnen, erstellen Sie die folgende Kennzahl:

=yearname(date)

Ergebnistabelle
date	=yearname(date)
01/13/2020	2020
02/26/2020	2020
03/27/2020	2020
04/16/2020	2020
05/21/2020	2020
08/14/2020	2020
10/07/2020	2020
12/05/2020	2020
01/22/2021	2021
02/03/2021	2021
03/17/2021	2021
04/23/2021	2021
05/04/2021	2021
06/30/2021	2021
07/26/2021	2021
12/27/2021	2021
06/06/2022	2022
07/18/2022	2022
11/14/2022	2022
12/12/2022	2022

Die Kennzahl „year_name“ wird im Diagrammobjekt erstellt, indem die Funktion yearname() verwendet und das Feld als Argument der Funktion übergeben wird.

Die Funktion yearname() identifiziert, in welches Jahr der Datumswert fällt, und gibt dies als vierstelligen Jahreswert zurück.

Diagramm der Funktion „yearname()“, die 2021 als den Jahreswert anzeigt — Diagramm der Funktion yearname() mit 2021 als Jahreswert

Beispiel 5 – Szenario

Übersicht

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

Das Ladeskript umfasst:

Den gleichen Datensatz wie im ersten Beispiel.
Die Systemvariable DateFormat, die auf „MM/DD/YYYY“ festgelegt ist.

Der Endbenutzer möchte ein Diagramm, das den Gesamtumsatz nach Quartal für die Transaktionen darstellt. Verwenden Sie die Funktion yearname() als berechnete Dimension, um dieses Diagramm zu erstellen, wenn die Dimension yearname() im Datenmodell nicht verfügbar ist.

Ladeskript

SET DateFormat='MM/DD/YYYY'; 

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

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle.

Erstellen Sie die folgende berechnete Dimension, um Aggregierungen nach Jahr zu vergleichen:

=yearname(date)

Erstellen Sie die folgende Kennzahl:

=sum(amount)

Legen Sie die Zahlenformatierung der Kennzahl auf Währung fest.

Ergebnistabelle
yearname(date)	=sum(amount)
2020	$463.55
2021	$457.69
2022	$294.35

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