TimePeriods (FPScript)
Durchsucht einen Datensatz mit Kalenderzeitwerten nach periodischen Zeitausschnitten.
Syntax
TimePeriods(DataSet, Criterion, LowerBound, UpperBound [ , Operation = EVENT_DEFAULT ])
Die Syntax der TimePeriods-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
Der Datensatz mit Kalenderzeitwerten, in dem nach Perioden gesucht werden soll. Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal, Signalreihe und Signalreihe mit zweidimensionaler X-Komponente. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||
Criterion |
Gibt an, welches Datumselement der Suche zugrunde gelegt werden soll. Das Argument Criterion kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||
LowerBound |
Gibt die Untergrenze des Zeitausschnittes an. Wenn Sie einen Wert mit Einheit angeben, muss diese zum gewählten Datumselement passen. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||
UpperBound |
Gibt die Obergrenze des Zeitausschnittes an. Wenn Sie einen Wert mit Einheit angeben, muss diese zum gewählten Datumselement passen. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||
Operation |
Legt die Arbeitsweise der Funktion fest. Das Argument Operation kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert EVENT_DEFAULT gesetzt. |
Anmerkungen
Das Ergebnis ist immer vom Datentyp Kalenderzeit.
Bei Signalen und Signalreihen wird die X-Komponente durchsucht.
Für den Fall, dass LowerBound kleiner oder gleich UpperBound ist, liegt ein Wert im Intervall, wenn er größer oder gleich LowerBoundund kleiner oder gleich UpperBound ist. Wird LowerBound größer als UpperBound angegeben, dann liegt ein Wert im Intervall, wenn er größer oder gleich LowerBoundoder kleiner oder gleich UpperBound ist. Dies entspricht annähernd eine Komplementbildung.
Für die Datumselemente SECOND, MINUTE und HOUR können Sie die Intervallgrenzen als Fließkommazahl angeben.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
TimePeriods(TimeSignal, SECOND, 3.5, 12.3) |
Liefert die Indizes der Werte des Signals 'TimeSignal' zurück, die im Intervall [3.5, 12.3] Sekunden in jeder Minute liegen. |
TimePeriods(TimeSignal, SECOND, 200 ms, 600 ms) |
Liefert die Indizes der Werte des Signals 'TimeSignal' zurück, die im Intervall [0.2, 0.6] Sekunden in jeder Minute liegen. |
TimePeriods(SignalSeries, WEEKDAY, MONDAY, FRIDAY, EVENT_SETVOID) |
Liefert die Signalreihe, bei der alle Y-Werte, die auf ein Wochenende fallen, ungültig gesetzt wurden. |
IndexAnd(TimePeriods(TimeSignal, WEEKDAY, MONDAY, FRIDAY), TimePeriods(TimeSignal, HOUR, 9.0, 17.5)) |
Liefert die Indizes der Werte des Signals 'TimeSignal' zurück, auf einen Werktag fallen und im Bereich von 9:00 bis 17:30 Uhr liegen. |