Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

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 des Zeitraums der Funktion yearname().

Diagramm, das den Zeitraum anzeigt, in dem die Funktion „yearname“ ein Ergebnis zurückgibt.

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 der Funktion yearname() mit April als erstem Monat des Jahres.

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

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

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

Beispiel 2 – period_no

Beispiel 3 – first_month_of_year

Beispiel 4 – Diagrammobjektbeispiel

Beispiel 5 – Szenario

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!