Diese Funktion gibt das aktuelle Datum zurück. Die Funktion gibt Werte im Systemvariablenformat DateFormat zurück.
Syntax:
today([ timer_mode])
Rückgabe Datentyp: dual
Die Funktion today() kann entweder im Ladeskript oder in Diagrammobjekten verwendet werden.
Der Standardwert von timer_mode ist 1.
| Argument | Beschreibung |
|---|---|
| timer_mode |
Kann folgende Werte haben: 0 (Tag des letzten abgeschlossenen Datenladevorgangs) InformationshinweisWenn Sie die Funktion in einem Ladeskript verwenden, gibt timer_mode=0 den Tag des letzten abgeschlossenen Datenladevorgangs an, während timer_mode=1 den Tag des aktuellen Datenladevorgangs angibt.
|
| timer_mode value | Ergebnis bei Verwendung im Ladeskript | Ergebnis bei Verwendung im Diagrammobjekt |
|---|---|---|
| 0 | Gibt ein Datum im Format der Systemvariablen DateFormat für den letzten erfolgreichen Datenladevorgang vor dem neuesten Datenladevorgang zurück. | Gibt ein Datum im Format der Systemvariablen DateFormat für den neuesten Datenladevorgang zurück. |
|
1 |
Gibt ein Datum im Format der Systemvariablen DateFormat für den neuesten Datenladevorgang zurück. | Gibt ein Datum im Format der Systemvariablen DateFormat für den Funktionsaufruf zurück. |
|
2 |
Gibt ein Datum im Format der Systemvariablen DateFormat für den Zeitpunkt zurück, zu dem die Sitzung des Benutzers in der Anwendung begann. Dieser wird erst aktualisiert, wenn der Benutzer das Skript neu lädt. | Gibt das Datum im Format der Systemvariablen DateFormat für den Zeitpunkt zurück, zu dem die Sitzung des Benutzers in der Anwendung begann. Dieser wird aktualisiert, wenn eine neue Sitzung beginnt oder wenn die Daten in der Anwendung neu geladen werden. |
Verwendung
Die Funktion today() wird häufig als Komponente innerhalb einer Formel verwendet. Zum Beispiel kann sie verwendet werden, um die Zinsen zu berechnen, die in einem Monat bis dato aufgelaufen sind.
Die folgende Tabelle erläutert das Ergebnis, das von der Funktion today() bei verschiedenen Werten für das Argument timer_mode zurückgegeben wird:
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.
Beispiel 1 – Generierung von Objekten anhand des Ladeskripts
Übersicht
Im folgenden Beispiel werden drei Variablen mit der Funktion today() erstellt. Jede Variable verwendet eine der Optionen timer_mode, um deren Auswirkung zu demonstrieren.
Damit der Zweck der Variablen demonstriert wird, laden Sie das Skript und laden Sie es nach 24 Stunden ein zweites Mal. Das führt dazu, dass die Variablen today(0) und today(1) unterschiedliche Werte zeigen und damit ihren Zweck demonstrieren.
Ladeskript
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);Ergebnisse
Erstellen Sie drei Textfelder anhand der Anleitung unten, sobald die Daten ein zweites Mal geladen wurden.
Erstellen Sie zunächst ein Textfeld für zuvor geladene Daten.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie dem Objekt die folgende Kennzahl hinzu:
=vPreviousDataLoad
-
Wählen Sie unter Darstellung die Option Show titles aus und fügen Sie den Titel „Zeit des vorherigen Neuladevorgangs“ zum Objekt hinzu.
Erstellen Sie als Nächstes ein Textfeld für Daten, die derzeit geladen werden.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie dem Objekt die folgende Kennzahl hinzu:
=vCurrentDataLoad
-
Wählen Sie unter Darstellung die Option Show titles aus und fügen Sie den Titel „Zeit des aktuellen Neuladevorgangs“ zum Objekt hinzu.
Erstellen Sie ein letztes Textfeld, das anzeigt, wann die Sitzung des Benutzers in der Anwendung gestartet wurde.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie dem Objekt die folgende Kennzahl hinzu:
=vApplicationOpened
-
Wählen Sie unter Darstellung die Option Show titles aus und fügen Sie den Titel „Start der Benutzersitzung“ zum Objekt hinzu.
Diagramm mit Variablen, die anhand der Funktion today() im Ladeskript erstellt wurden
Die obige Abbildung zeigt Beispielwerte für jede der erstellten Variablen. Die Werte können beispielsweise wie folgt aussehen:
-
Vorherige Ladezeit: 06/22/2022
-
Aktuelle Ladezeit: 06/23/2022
-
Beginn der Benutzersitzung: 06/23/2022
Beispiel 2 – Generierung von Objekten ohne Ladeskript
Übersicht
Im folgenden Beispiel werden drei Diagrammobjekte mit der Funktion today() erstellt. Jedes Diagrammobjekt verwendet eine der Optionen für timer_mode, um deren Auswirkung zu demonstrieren.
Für dieses Beispiel gibt es kein Ladeskript.
Ergebnisse
Nachdem die Daten ein zweites Mal geladen wurden, erstellen Sie drei Textfelder.
Erstellen Sie zuerst ein Textfeld für den neuesten Datenladevorgang.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie die folgende Kennzahl hinzu.
=today(0)
-
Wählen Sie unter Darstellung die Option Titel anzeigen aus und fügen Sie den Titel „Neuester Datenladevorgang“ zum Objekt hinzu.
Erstellen Sie dann ein Textfeld, das die aktuelle Uhrzeit anzeigt.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie die folgende Kennzahl hinzu:
=today(1)
-
Wählen Sie unter Darstellung die OptionTitel anzeigen aus und fügen Sie den Titel „Aktuelle Uhrzeit“ zum Objekt hinzu.
Erstellen Sie ein letztes Textfeld, das anzeigt, wann die Sitzung des Benutzers in der Anwendung gestartet wurde.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Textfeld mithilfe des Diagrammobjekts Text und Bild.
-
Fügen Sie die folgende Kennzahl hinzu:
=today(2)
-
Wählen Sie unter Darstellung die Option Titel anzeigen aus und fügen Sie den Titel „Beginn der Benutzersitzung“ zum Objekt hinzu.
Diagramm mit Objekten, die anhand der Funktion today() ohne Ladeskript erstellt wurden
Die obige Abbildung zeigt Beispielwerte für jedes der erstellten Objekte. Die Werte können beispielsweise wie folgt aussehen:
-
Neuester Datenladevorgang: 06/23/2022
-
Aktuelle Uhrzeit: 06/23/2022
-
Beginn der Benutzersitzung: 06/23/2022
Das Diagrammobjekt „Neuester Datenladevorgang“ verwendet einen Wert für timer_mode von 0. Damit wird ein Zeitstempel für die Uhrzeit zurückgegeben, zu der die Daten zum letzten Mal erfolgreich geladen wurden.
Das Diagrammobjekt „Aktuelle Uhrzeit“ verwendet einen Wert für timer_mode von 1. Damit wird die aktuelle Uhrzeit der Systemuhr zurückgegeben. Wenn das Arbeitsblatt oder Objekt aktualisiert wird, wird dieser Wert aktualisiert.
Das Diagrammobjekt „Beginn der Benutzersitzung“ verwendet einen Wert für timer_mode von 2. Damit wird der Zeitstempel des Zeitpunkts zurückgegeben, zu dem die Anwendung geöffnet wurde und die Benutzersitzung begann.