Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

yeartodate - Skript- und Diagrammfunktion

Diese Funktion findet den Eingabe-Zeitstempel innerhalb des Jahres mit dem Datum, an welchem das Skript zuletzt aufgerufen wurde, und gibt True zurück, wenn der Zeitstempel gefunden wurde bzw. False, wenn er nicht gefunden wurde.

Syntax:  

YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])

Rückgabe Datentyp: Boolesch

Informationshinweis

In Qlik Sense wird der boolesche Wert „wahr“ durch -1 dargestellt, der Wert „falsch“ durch 0.

Beispieldiagramm der Funktion yeartodate()

Diagramm mit den Datumswerten, für die die Funktion „yeartodate“ einen Wert von TRUE oder FALSE zurückgibt.

Wird kein weiterer Parameter verwendet, ist das Jahr bis dato das laufende Kalenderjahr, vom 1. Januar bis einschließlich des Tags der letzten Ausführung des Skripts.

In anderen Worten wird die Funktion yeartodate(), wenn sie ohne zusätzliche Parameter ausgelöst wird, dazu verwendet, einen Zeitstempel auszuwerten und ein boolesches Ergebnis basierend darauf zurückzugeben, ob das Datum innerhalb des Kalenderjahres bis einschließlich dem Datum liegt, an dem der Ladevorgang stattfand.

Es ist jedoch auch möglich, das Startdatum des Jahres zu überschreiben, indem das Argument firstmonth verwendet wird, und es können Vergleiche mit dem davor oder danach liegenden Jahr anhand des Arguments yearoffset vorgenommen werden.

Im Fall historischer Datensätze gibt die Funktion yeartodate() einen festzulegenden Parameter todaydate an, mit dem stattdessen der Zeitstempel mit dem Kalenderjahr bis einschließlich dem Datum verglichen wird, das im Argument todaydate angegeben wird.

Argumente
Argument Beschreibung
timestamp

Der zu beurteilende Zeitstempel, beispielsweise „10/12/2012“.

yearoffset

Durch das Festlegen von yearoffset, liefert yeartodate für denselben Zeitraum in einem anderen Jahr True. Ein negativer Wert von yearoffset verweist auf ein vorheriges Jahr, ein positiver Startwert auf ein Jahr in der Zukunft. Das aktuellste Jahr bis dato wird durch die Festlegung von yearoffset = -1 ausgewählt. Ist nichts definiert, wird 0 angenommen.

firstmonth

Durch Angabe eines Werts für firstmonth zwischen 1 und 12 (fehlt die Angabe, wird 1 angenommen) wird der Jahresbeginn auf den ersten Tag eines beliebigen Monats festgelegt. Wenn Sie beispielsweise mit einem Geschäftsjahr arbeiten möchten, das am 1. Mai beginnt, geben Sie firstmonth = 5 an. Ein Wert von 1 gibt ein Geschäftsjahr an, das am 1. Januar beginnt, und ein Wert von 12 gibt ein Geschäftsjahr an, das am 1. Dezember beginnt.

todaydate Durch Angabe einer Zahl für todaydate kann das Ende der Zeitperiode festgelegt werden. Fehlt dieser Parameter, wird stattdessen der Zeitstempel der letzten Ausführung des Skripts verwendet.

Verwendung

Die Funktion yeartodate() gibt einen booleschen Wert zurück. In der Regel wird dieser Funktionstyp als Bedingung in einem IF-Ausdruck verwendet. Damit wird eine Aggregierung oder Berechnung zurückgegeben, abhängig davon, ob das ausgewertete Datum in das Jahr bis einschließlich zum letzten Ladedatum der Anwendung fällt.

Beispielsweise kann die Funktion „YearToDate()“ verwendet werden, um alle bisher im laufenden Jahr gefertigten Geräte zu identifizieren.

In den folgenden Beispielen wird als letzte Ladezeit 11/18/2011 angenommen.

Funktionsbeispiele
Beispiel Ergebnis
yeartodate( '11/18/2010') gibt False zurück
yeartodate( '02/01/2011') gibt True zurück
yeartodate( '11/18/2011') gibt True zurück
yeartodate( '11/19/2011') gibt False zurück
yeartodate( '11/19/2011', 0, 1, '12/31/2011') gibt True zurück
yeartodate( '11/18/2010', -1) gibt True zurück
yeartodate( '11/18/2011', -1) gibt False zurück
yeartodate( '04/30/2011', 0, 5) gibt False zurück
yeartodate( '05/01/2011', 0, 5) gibt True 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.

Beispiel 1 – einfaches Beispiel

Beispiel 2 – yearoffset

Beispiel 3 – firstmonth

Beispiel 4 – todaydate

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!