Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

monthsname - Skript- und Diagrammfunktion

Diese Funktion liefert einen Anzeigewert, der den Bereich der Monate des Zeitraums (formatiert nach der MonthNames-Skriptvariable) sowie das Jahr darstellt. Der zugrunde liegende numerische Wert entspricht dem Zeitstempel der ersten Millisekunde des Monats, Zweimonatszeitraums, Quartals, Viermonatszeitraums oder Halbjahrs, in dem ein Basisdatum liegt.

Syntax:  

MonthsName(n_months, date[, period_no[, first_month_of_year]])

Rückgabe Datentyp: dual

Diagramm der Funktion „monthsname“

Beispieldiagramm mit dem Monatsbereich, der von der Funktion „monthsname“ anhand eines spezifischen Eingabedatums zurückgegeben wird.

Die Funktion monthsname() unterteilt das Jahr in Segmente, gestützt auf das angegebene Argument n_months. Dann wertet sie das Segment aus, zu dem jedes angegebene date gehört, und gibt die Namen des Start- und Endmonats für dieses Segment sowie das Jahr zurück. Die Funktion bietet auch die Möglichkeit, diese Grenzen aus vorangehenden oder darauffolgenden Segmenten zurückzugeben und neu zu definieren, welcher der erste Monat des Jahres ist.

Die folgenden Segmente des Jahres sind in der Funktion als n_month-Argumente verfügbar:

Mögliche n_month-Argumente
Zeiträume Anzahl der Monate
Monat 1
Zweimonatszeitraum 2
Quartal 3
Viermonatszeitraum

4

Halbjahr 6
Argumente
Argument Beschreibung
n_months Die Anzahl der Monate, die den Zeitraum definiert. Eine Ganzzahl oder eine Formel, die eine Ganzzahl mit einem der folgenden Werte ergibt: 1 (entspricht der Funktion inmonth()), 2 (Zweimonatszeitraum), 3 (entspricht der Funktion inquarter()), 4 (Viermonatszeitraum) oder 6 (Halbjahr).
date Datum oder Zeitstempel für die Evaluierung.
period_no Mit period_no, einer ganze Zahl oder einer Formel, die eine ganze Zahl ergibt, kann ein anderer Beginn für den Zeitraum festgelegt werden, wobei 0 für den Zeitraum steht, der base_date enthält. Negative Werte von period_no stehen für vorangehende, positive Werte für nachfolgende Zeiträume.
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.

Verwendung

Die Funktion monthsname() ist nützlich, wenn Sie dem Benutzer die Möglichkeit geben möchten, Aggregierungen für einen selbst gewählten Zeitraum zu vergleichen. Sie können beispielsweise eine Eingabevariable bereitstellen, damit der Benutzer den Gesamtumsatz von Produkten nach Monat, Quartal oder Halbjahr anzeigen kann.

Diese Dimensionen können entweder im Ladeskript erstellt werden, indem die Funktion als Feld in einer Master-Kalender-Tabelle hinzugefügt wird, oder indem die Dimension direkt in einem Diagramm als berechnete Dimension erstellt wird.

Funktionsbeispiele
Beispiel Ergebnis
monthsname(4, '10/19/2013') Gibt „Sep-Dec 2013“ zurück. In diesem und den anderen Beispielen ist die Anweisung SET Monthnames auf Jan;Feb;Mar usw. festgelegt.
monthsname(4, '10/19/2013', -1) Gibt „May-Aug 2013“ zurück.
monthsname(4, '10/19/2013', 0, 2) Gibt „Oct-Jan 2014“ zurück, da festgelegt ist, dass das Jahr im Monat 2 beginnt. Daher endet der Viermonatszeitraum im ersten Monat des Folgejahres.

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.

Beispiel 1 – einfaches Beispiel

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!