Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

weekname - Skript- und Diagrammfunktion

Diese Funktion liefert den Zeitstempel der ersten Millisekunde der Kalenderwoche, in der date liegt. Das Ergebnis wird als Kombination von Jahr und Wochennummer formatiert.

Syntax:  

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

Die Funktion weekname() bestimmt, in welche Woche das Datum fällt, und gibt die Wochennummer und das Jahr dieser Woche zurück. Der erste Tag der Woche wird durch die Systemvariable FirstWeekDay bestimmt. Sie können aber auch den ersten Tag der Woche ändern, indem Sie das Argument first_week_day in der Funktion weekname() verwenden.

 In Qlik Sense werden die regionalen Einstellungen bei der Erstellung der App abgerufen, und die entsprechenden Einstellungen werden im Skript als Umgebungsvariablen gespeichert.

Ein nordamerikanischer App-Entwickler erhält oft Set BrokenWeeks=1; im Skript, was gestückelten Wochen entspricht. Ein europäischer App-Entwickler erhält oft Set BrokenWeeks=0; im Skript, was nicht gestückelten Wochen entspricht.

Wenn Ihre Anwendung gestückelte Wochen verwendet, beginnt die Zählung der Wochennummer am 1. Januar und endet am Tag vor der Systemvariablen FirstWeekDay, unabhängig davon, wie viele Tage verstrichen sind.

Wenn Ihre Anwendung jedoch vollständige Wochen verwendet, kann Woche 1 im Vorjahr oder in den ersten Tagen im Januar beginnen. Das hängt davon ab, wie Sie die Systemvariablen ReferenceDay und FirstWeekDay verwenden.

Beispiel der Funktion „Weekname“
Datum ISO-Wochenname US-Wochenname
Sat 2020 Dec 26 2020/52 2020/52
Sun 2020 Dec 27 2020/52 2020/53
Mon 2020 Dec 28 2020/53 2020/53
Tue 2020 Dec 29 2020/53 2020/53
Wed 2020 Dec 30 2020/53 2020/53
Thu 2020 Dec 31 2020/53 2020/53
Fri 2021 Jan 1 2020/53 2021/01
Sat 2021 Jan 2 2020/53 2021/01
Sun 2021 Jan 3 2020/53 2021/02
Mon 2021 Jan 4 2021/01 2021/02
Tue 2021 Jan 5 2021/01 2021/02

Die Funktion weekname() ist nützlich, wenn Sie Aggregierungen nach Wochen vergleichen möchten.

Das ist beispielsweise der Fall, wenn Sie den Gesamtumsatz von Produkten nach Woche anzeigen möchten. Um die Einheitlichkeit mit der Umgebungsvariablen BrokenWeeks in der Anwendung zu wahren, verwenden Sie weekname() anstelle von lunarweekname(). Wenn die Anwendung vollständige Wochen verwendet, kann Woche 1 Tage vom Dezember des Vorjahres enthalten oder Tage im Januar des laufenden Jahres ausschließen. Wenn die Anwendung unvollständige Wochen verwendet, kann Woche 1 weniger als sieben Tage enthalten.

Rückgabe Datentyp: dual

Argumente
Argument Beschreibung
timestamp Datum oder Zeitstempel für die Evaluierung.
period_no shift ist eine ganze Zahl, wobei 0 für die Woche steht, die date enthält. Negative Werte von "shift" stehen für vorangehende Wochen, positive Werte für nachfolgende Wochen.
first_week_day

Legt den Tag fest, an dem die Woche beginnt. Ist nichts definiert, wird der Wert der Variable FirstWeekDay verwendet.

Die möglichen Werte für first_week_day sind 0 für Montag, 1 für Dienstag, 2 für Mittwoch, 3 für Donnerstag, 4 für Freitag, 5 für Samstag und 6 für Sonntag.

Weitere Informationen über die Systemvariable finden Sie unter FirstWeekDay.

broken_weeks

Wenn Sie broken_weeks nicht angeben, wird der Wert der Variablen BrokenWeeks verwendet, um festzulegen, ob die Wochen gestückelt sind oder nicht.

Weitere Informationen über die Systemvariable finden Sie unter BrokenWeeks.

reference_day

Wenn Sie reference_day nicht angeben, wird der Wert der Variablen ReferenceDay verwendet, um festzulegen, welcher Tag im Januar als Referenztag für die Definition von Woche 1 konfiguriert wird. Standardmäßig verwenden Qlik Sense-Funktionen 4 als Referenztag. Das heißt, dass die Woche 1 den 4. Januar enthalten muss, oder anders ausgedrückt: Woche 1 muss immer mindestens 4 Tage im Januar enthalten.

Weitere Informationen über die Systemvariable finden Sie unter ReferenceDay.

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.

Die folgenden Beispiele nehmen an:

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Funktionsbeispiele
Beispiel Ergebnis
weekname('01/12/2013') Liefert 2013/02.
weekname('01/12/2013', -1) Returns 2013/01.
weekname('01/12/2013', 0, 1) Liefert 2013/02.

Beispiel 1 – Datum ohne zusätzliche Argumente

Beispiel 2 – period_no

Beispiel 3 – first_week_day

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!