Diese Funktion liefert den Anzeigewert der ersten Millisekunde des ersten Tags der Mondwoche, in der date liegt. Das Ergebnis wird als Kombination von Jahr und Mondwochennummer formatiert. Bei Mondwochen in Qlik Sense wird der 1. Januar als der erste Tag der Woche gezählt. Mit Ausnahme der letzten Woche des Jahres umfasst jede Woche genau sieben Tage.
Syntax:
LunarWeekName(date [, period_no[, first_week_day]])
Rückgabe Datentyp: dual
Beispieldiagramm der Funktion lunarweekname()
Die Funktion lunarweekname() bestimmt, in welche Mondwoche das Datum fällt, wobei die Wochenzählung am 1. Januar beginnt. Dann wird ein Wert zurückgegeben, der aus year/weekcount besteht.
| Argument | Beschreibung |
|---|---|
| date | Datum oder Zeitstempel für die Evaluierung. |
| period_no | period_no ist eine ganze Zahl oder eine Formel, die eine ganze Zahl ergibt, wobei 0 für die Mondwoche steht, die date enthält. Negative Werte von period_no stehen für vorangehende, positive Werte für nachfolgende Mondwochen. |
| first_week_day | Ein Startwert, der größer oder kleiner als Null sein kann. Dadurch wird der Beginn des Jahres um die angegebene Anzahl an Tagen und/oder den Bruchteil eines Tages verschoben. |
Verwendung
Die Funktion lunarweekname() ist nützlich, wenn Sie Aggregierungen nach Mondwochen vergleichen möchten. Beispielsweise kann die Funktion verwendet werden, um den Gesamtumsatz von Produkten nach Mondwochen zu bestimmen. Mondwochen sind nützlich, wenn Sie sicherstellen möchten, dass alle Werte in der ersten Woche des Jahres nur Werte ab dem 1. Januar als frühestes Datum umfassen.
Diese Dimensionen können im Ladeskript erstellt werden, indem die Funktion verwendet wird, um ein Feld in einer Master-Kalender-Tabelle zu erstellen. Diese Funktion kann auch direkt als berechnete Dimension in einem Diagramm verwendet werden.
| Beispiel | Ergebnis |
|---|---|
| lunarweekname('01/12/2013') | Gibt 2006/02 zurück. |
| lunarweekname('01/12/2013', -1) | Gibt 2006/01 zurück. |
| lunarweekname('01/12/2013', 0, 1) | Gibt 2006/02 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.
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.
Beispiel 1 – Datum ohne zusätzliche Argumente
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
-
Ein Datensatz enthält eine Reihe von Transaktionen für 2022 und wird in eine Tabelle namens Transactions geladen.
-
Datumsfeld, das im Format der Systemvariablen DateFormat (MM/TT/JJJJ) bereitgestellt wird
-
Erstellung eines Felds lunar_week_name, das das Jahr und die Wochennummer für die Mondwoche zurückgibt, in der die Transaktionen stattfanden
Ladeskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
lunarweekname(date) as lunar_week_name
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
lunar_week_name
| date | lunar_week_name |
|---|---|
| 1/7/2022 | 2022/01 |
| 1/19/2022 | 2022/03 |
| 2/5/2022 | 2022/06 |
| 2/28/2022 | 2022/09 |
| 3/16/2022 | 2022/11 |
| 4/1/2022 | 2022/13 |
| 5/7/2022 | 2022/19 |
| 5/16/2022 | 2022/20 |
| 6/15/2022 | 2022/24 |
| 6/26/2022 | 2022/26 |
| 7/9/2022 | 2022/28 |
| 7/22/2022 | 2022/29 |
| 7/23/2022 | 2022/30 |
| 7/27/2022 | 2022/30 |
| 8/2/2022 | 2022/31 |
| 8/8/2022 | 2022/32 |
| 8/19/2022 | 2022/33 |
| 9/26/2022 | 2022/39 |
| 10/14/2022 | 2022/41 |
| 10/29/2022 | 2022/44 |
Das Feld lunar_week_name wird in der vorangehenden load-Anweisung erstellt, indem die Funktion lunarweekname() verwendet und das Feld date als Argument der Funktion übergeben wird.
Die Funktion lunarweekname() identifiziert, in welche Mondwoche der Datumswert fällt, und gibt das Jahr und die Wochennummer für dieses Datum zurück.
Diagramm der Funktion lunarweekname(), Beispiel ohne zusätzliche Argumente
Transaktion 8189 fand am 19. Januar statt. Die Funktion lunarweekname() identifiziert, dass dieses Datum in die Mondwoche fällt, die am 15. Januar beginnt. Das ist die dritte Mondwoche des Jahres. Daher ist der von dieser Transaktion zurückgegebene Wert für lunar_week_name 2022/03.
Beispiel 2 – Datum mit Argument „period_no“
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
-
Derselbe Datensatz und dasselbe Szenario wie im ersten Beispiel.
-
Es wird ein Feld previous_lunar_week_name erstellt, das das Jahr und die Wochennummer für die Mondwoche vor dem Transaktionsdatum zurückgibt.
Ladeskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
lunarweekname(date,-1) as previous_lunar_week_name
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
previous_lunar_week_name
| date | previous_lunar_week_name |
|---|---|
| 1/7/2022 | 2021/52 |
| 1/19/2022 | 2022/02 |
| 2/5/2022 | 2022/05 |
| 2/28/2022 | 2022/08 |
| 3/16/2022 | 2022/10 |
| 4/1/2022 | 2022/12 |
| 5/7/2022 | 2022/18 |
| 5/16/2022 | 2022/19 |
| 6/15/2022 | 2022/23 |
| 6/26/2022 | 2022/25 |
| 7/9/2022 | 2022/27 |
| 7/22/2022 | 2022/28 |
| 7/23/2022 | 2022/29 |
| 7/27/2022 | 2022/29 |
| 8/2/2022 | 2022/30 |
| 8/8/2022 | 2022/31 |
| 8/19/2022 | 2022/32 |
| 9/26/2022 | 2022/38 |
| 10/14/2022 | 2022/40 |
| 10/29/2022 | 2022/43 |
Da in diesem Fall eine period_no von -1 als Versatzargument in der Funktion lunarweekname() verwendet wurde, identifiziert die Funktion zuerst die Mondwoche, in der die Transaktionen stattfanden. Dann gibt sie das Jahr und die Nummer der davor liegenden Woche zurück.
Diagramm der Funktion lunarweekname(), Beispiel „period_no“
Transaktion 8189 fand am 19. Januar statt. Die Funktion lunarweekname() identifiziert, dass diese Transaktion in der dritten Mondwoche des Jahres stattfand. Daher gibt sie das Jahr und den Wert für eine Woche davor, 2022/02, für das Feld previous_lunar_week_name zurück.
Beispiel 3 – Datum mit dem Argument „first_week_day“
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript verwendet den gleichen Datensatz und das gleiche Szenario wie das erste Beispiel. In diesem Beispiel wird für den Beginn der Mondwochen der 5. Januar festgelegt.
Ladeskript
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
lunarweekname(date,0,4) as lunar_week_name
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:
-
date
-
lunar_week_name
| date | lunar_week_name |
|---|---|
| 1/7/2022 | 2022/01 |
| 1/19/2022 | 2022/03 |
| 2/5/2022 | 2022/05 |
| 2/28/2022 | 2022/08 |
| 3/16/2022 | 2022/11 |
| 4/1/2022 | 2022/13 |
| 5/7/2022 | 2022/18 |
| 5/16/2022 | 2022/19 |
| 6/15/2022 | 2022/24 |
| 6/26/2022 | 2022/25 |
| 7/9/2022 | 2022/27 |
| 7/22/2022 | 2022/29 |
| 7/23/2022 | 2022/29 |
| 7/27/2022 | 2022/30 |
| 8/2/2022 | 2022/30 |
| 8/8/2022 | 2022/31 |
| 8/19/2022 | 2022/33 |
| 9/26/2022 | 2022/38 |
| 10/14/2022 | 2022/41 |
| 10/29/2022 | 2022/43 |
Diagramm der Funktion lunarweekname(), Beispiel „first_week_day“
Da in diesem Fall das Argument first_week_date von 4 in der Funktion lunarweekname() verwendet wird, wird der Start der Mondwochen vom 1. auf den 5. Januar verschoben.
Die Transaktion 8188 fand am 7. Januar statt. Da die Mondwochen am 5. Januar beginnen, identifiziert die Funktion lunarweekname() die Mondwoche des 7. Januar als die erste Mondwoche des Jahres. Daher ist der für diese Transaktion zurückgegebene Wert von lunar_week_name 2022/01.
Beispiel 4 – Diagrammobjektbeispiel
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript verwendet den gleichen Datensatz und das gleiche Szenario wie das erste Beispiel.
In diesem Beispiel wird jedoch der unveränderte Datensatz in die Anwendung geladen. Die Berechnung, die die Nummer der Mondwoche und das Jahr zurückgibt, in denen die Transaktionen stattfanden, wird als Kennzahl in einem Diagrammobjekt der Anwendung erstellt.
Ladeskript
Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu: date.
Um das Startdatum der Mondwoche zu berechnen, in dem eine Transaktion stattfindet, erstellen Sie die folgende Kennzahl:
=lunarweekname(date)
| date | =lunarweekname(date) |
|---|---|
| 1/7/2022 | 2022/01 |
| 1/19/2022 | 2022/03 |
| 2/5/2022 | 2022/06 |
| 2/28/2022 | 2022/09 |
| 3/16/2022 | 2022/11 |
| 4/1/2022 | 2022/13 |
| 5/7/2022 | 2022/19 |
| 5/16/2022 | 2022/20 |
| 6/15/2022 | 2022/24 |
| 6/26/2022 | 2022/26 |
| 7/9/2022 | 2022/28 |
| 7/22/2022 | 2022/29 |
| 7/23/2022 | 2022/30 |
| 7/27/2022 | 2022/30 |
| 8/2/2022 | 2022/31 |
| 8/8/2022 | 2022/32 |
| 8/19/2022 | 2022/33 |
| 9/26/2022 | 2022/39 |
| 10/14/2022 | 2022/41 |
| 10/29/2022 | 2022/44 |
Die Kennzahl lunar_week_name wird im Diagrammobjekt erstellt, indem die Funktion lunarweekname() verwendet und das Feld date als Argument der Funktion übergeben wird.
Die Funktion lunarweekname() identifiziert, in welche Mondwoche der Datumswert fällt, und gibt das Jahr und die Wochennummer für dieses Datum zurück.
Diagramm der Funktion lunarweekname(), Diagrammobjektbeispiel
Transaktion 8189 fand am 19. Januar statt. Die Funktion lunarweekname() identifiziert, dass dieses Datum in die Mondwoche fällt, die am 15. Januar beginnt. Das ist die dritte Mondwoche des Jahres. Daher ist der Wert von lunar_week_name für diese Transaktion 2022/03.