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“
DatumISO-WochennameUS-Wochenname
Sat 2020 Dec 262020/522020/52
Sun 2020 Dec 272020/522020/53
Mon 2020 Dec 282020/532020/53
Tue 2020 Dec 292020/532020/53
Wed 2020 Dec 302020/532020/53
Thu 2020 Dec 312020/532020/53
Fri 2021 Jan 12020/532021/01
Sat 2021 Jan 22020/532021/01
Sun 2021 Jan 32020/532021/02
Mon 2021 Jan 42021/012021/02
Tue 2021 Jan 52021/012021/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
ArgumentBeschreibung
timestampDatum oder Zeitstempel für die Evaluierung.
period_noshift 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.

Die standardmäßigen regionalen Einstellungen in Apps basieren auf den regionalen Systemeinstellungen der Computer oder Server, auf denen Qlik Sense installiert ist. Wenn der Qlik Sense-Server, auf den Sie zugreifen, auf Schweden festgelegt ist, verwendet der Dateneditor die schwedischen regionalen Einstellungen für Datums-, Uhrzeit- und Währungsangaben. Diese Einstellungen im regionalen Format hängen nicht mit der Sprache zusammen, die in der Benutzeroberfläche von Qlik Sense angezeigt wird. Qlik Sense wird in der gleichen Sprache wie der von Ihnen verwendete Browser angezeigt.

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!