Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

week - Skript- und Diagrammfunktion

Diese Funktion gibt die Wochennummer zurück, die dem eingegebenen Datum entspricht.

Syntax:  

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Rückgabe Datentyp: ganze Zahl

Argumente
Argument Beschreibung
timestamp Datum oder Zeitstempel für die Evaluierung.
first_week_day

Legt den Tag fest, an dem die Woche beginnt. Ist nichts definiert, wird der Wert der Variablen 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.

Die Funktion week() bestimmt, in welche Woche das Datum fällt, und gibt die Wochennummer zurück.

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

Das bedeutet, dass die meisten europäischen App-Entwickler die folgenden Umgebungsvariablen gemäß der ISO 8601-Definition erhalten:

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

Ein nordamerikanischer App-Entwickler erhält oft die folgenden Umgebungsvariablen:

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

Der erste Tag der Woche wird durch die Systemvariable FirstWeekDay bestimmt. Sie können auch den ersten Tag der Woche ändern, indem Sie das Argument first_week_day in der Funktion week() verwenden.

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 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 Umgebungsvariablen FirstWeekDay und ReferenceDay verwenden.

Verwendung

Die Funktion The week() ist nützlich, wenn Sie Aggregierungen nach Wochen vergleichen möchten. Sie kann beispielsweise verwendet werden, wenn Sie den Gesamtumsatz von Produkten nach Woche anzeigen möchten. Die Funktion week() wird anstelle von weekname() gewählt, wenn der Benutzer möchte, dass die Berechnung nicht notwendigerweise die Systemvariablen BrokenWeeks, FirstWeekDay oder ReferenceDay der Anwendung verwendet.

Das ist beispielsweise der Fall, wenn Sie den Gesamtumsatz von Produkten nach Woche anzeigen möchten.

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 gestückelte Wochen verwendet, kann Woche 1 weniger als sieben Tage enthalten.

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 DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Funktionsbeispiele
Beispiel Ergebnis

week('12/28/2021')

Gibt 52 zurück.

week(44614) Gibt 8 zurück, da dies die Seriennummer für 02/22/2022 ist.
week('01/03/2021') Gibt 53 zurück.
week('01/03/2021',6) Liefert 1.

Beispiel 1 – Standardsystemvariablen

Beispiel 2 – first_week_day

Beispiel 3 – unbroken_weeks

Beispiel 4 – reference_day

Beispiel 5 – Diagrammobjektbeispiel

Beispiel 6 – 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!