Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

weekend - Skript- und Diagrammfunktion

Diese Funktion gibt einen Wert zurück, der dem Zeitstempel der letzten Millisekunde des letzten Tages der Kalenderwoche entspricht, in der date liegt. Das Ergebnis wird entsprechend dem im Skript definierten DateFormat formatiert.

Syntax:  

WeekEnd(timestamp [, period_no [, first_week_day ]])

Rückgabe Datentyp: dual

Die Funktion weekend() bestimmt, in welche Woche das Datum fällt. Sie gibt dann einen Zeitstempel im Datumsformat für die letzte Millisekunde dieser Woche zurück. Der erste Tag der Woche wird durch die Umgebungsvariable FirstWeekDay bestimmt. Dies kann jedoch durch das Argument first_week_day in der Funktion weekend() überschrieben werden.

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.

Verwendung

Die Funktion weekend() wird in der Regel als Teil einer Formel verwendet, wenn in der Berechnung die verbleibenden Tage der Woche für das angegebene Datum verwendet werden sollen. Beispiel: Ein Benutzer möchte die gesamten, während der Woche noch nicht fällig gewordenen Zinsen berechnen.

Die folgenden Beispiele nehmen an:

SET FirstWeekDay=0;

 

Beispiel Ergebnis
weekend('01/10/2013') Gibt 01/12/2013 23:59:59 zurück.
weekend('01/10/2013', -1) Gibt 01/05/2013 23:59:59. zurück.
weekend('01/10/2013', 0, 1) Gibt 01/14/2013 23:59:59 zurück.

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.

Beispiele:  

Wenn Sie ISO-Einstellungen für Wochen und Wochennummern verwenden möchten, müssen Sie Folgendes in das Skript einschließen:

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

Wenn Sie US-Einstellungen verwenden möchten, müssen Sie Folgendes in das Skript einschließen:

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

Die obigen Beispiele führen zu folgenden Ergebnissen für die Funktion weekend():

Beispiel der Funktion „Weekend“
Datum ISO-Wochenende US-Wochenende
Sat 2020 Dec 26 2020-12-27 12/26/2020
Sun 2020 Dec 27 2020-12-27 1/2/2021
Mon 2020 Dec 28 2021-01-03 1/2/2021
Tue 2020 Dec 29 2021-01-03 1/2/2021
Wed 2020 Dec 30 2021-01-03 1/2/2021
Thu 2020 Dec 31 2021-01-03 1/2/2021
Fri 2021 Jan 1 2021-01-03 1/2/2021
Sat 2021 Jan 2 2021-01-03 1/2/2021
Sun 2021 Jan 3 2021-01-03 1/9/2021
Mon 2021 Jan 4 2021-01-10 1/9/2021
Tue 2021 Jan 5 2021-01-10 1/9/2021
InformationshinweisIn der ISO-Spalte endet die Woche an Sonntagen, in der US-Spalte an Samstagen.

Beispiel 1 – einfaches Beispiel

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!