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.
Argumente
Argument
Beschreibung
timer_mode
Kann folgende Werte haben:
0 (Tag des letzten abgeschlossenen Datenladevorgangs) 1 (Tag des Funktionsaufrufs) 2 (Tag beim Öffnen der App)
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.
Funktionsbeispiele
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.
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 – 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.
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.
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.
Beispiel 3 – Szenario
Übersicht
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.
Das Ladeskript umfasst:
Ein Datensatz mit einer Reihe von Darlehenssalden wird in eine Tabelle namens Loans geladen.
Tabellendaten mit Feldern für die Darlehens-ID, den Saldo zum Monatsbeginn und den einfachen Zinssatz, der für jedes Darlehen pro Jahr berechnet wird.
Der Endbenutzer möchte ein Diagrammobjekt, das nach Darlehens-ID die aktuellen Zinsen anzeigt, die für jedes Darlehen im Monat bis dato aufgelaufen sind. Die Anwendung wird zwar nur einmal pro Woche geladen, aber der Benutzer möchte, dass die Ergebnisse aktualisiert werden, sooft das Objekt oder die Anwendung aktualisiert werden.
Die Funktion monthstart() verwendet die Funktion today(), um das aktuelle Datum als einziges Argument zurückzugeben, und gibt das Startdatum des aktuellen Monats zurück. Die Formel zieht dieses Ergebnis vom aktuellen Datum ab, wobei erneut die Funktion today() verwendet wird, und gibt die Anzahl der Tage zurück, die bisher im Monat verstrichen sind.
Dieser Wert wird dann mit dem Zinssatz multipliziert und durch 365 geteilt, um den effektiven Zinssatz für diesen Zeitraum zurückzugeben. Das Ergebnis wird dann mit dem Anfangssaldo des Darlehens multipliziert, was die Zinsen ergibt, die bislang in diesem Monat aufgelaufen sind.
Da der Wert von 1 als Argument timer_mode in den Funktionen today() innerhalb der Formel verwendet wird, wird bei jeder Aktualisierung des Diagrammobjekts (z. B. durch Öffnen der Anwendung, Aktualisieren der Seite, Wechseln zwischen Arbeitsblättern usw.) das aktuelle Datum zurückgegeben, und die Ergebnisse werden entsprechend aktualisiert.
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!