Typ Zeit
Die Dynamische Aufzählung Typ Zeit (DateTimeValueType) legt Auswahlmöglichkeiten für den "Typ" im Wertauflöser Relatives Datum mit Zeit fest:
Alle Optionen außer dem Typ "Benutzerdefiniert" sind vordefinierte Zeitangaben, für die ein Ausdruck (durch Selektion blau hervorgehoben im Screenshot unten) für die Datumsrechnung hinterlegt werden kann, der relativ zur aktuellen Systemzeit angewendet wird.
Für die Option "Benutzerdefiniert" (CUSTOM) wird der Ausdruck ignoriert (er ist per Standard leer), da stattdessen ein Ausdruck im Parameter "Zeitwert" im Relatives Datum mit Zeit-Wertauflöser verwendet wird (Details s. Relatives Datum mit Zeit).
Werksseitig sind folgende Definitionen für Standardwerte vorbelegt:
Name |
Lokalisierung (Deutsch) |
Ausdruck |
Kommentar |
Systemzeit |
|||
NOW |
Jetzt |
<leer> |
kein Ausdruck notwendig ("Jetzt" = Systemzeit ohne Versatz) |
Zeithorizont |
|||
LAST_HOUR |
Letzte Stunde |
-60m |
... der Zeitpunkt 3.600.000 Millisekunden vor 'Jetzt' (= "vor 60 Minuten") |
NEXT_HOUR |
Nächste Stunde |
+60m |
... der Zeitpunkt 3.600.000 Millisekunden nach 'Jetzt' (= "in 60 Minuten") |
Kalendertag (Periode) |
|||
START_TODAY |
Anfang heute |
0h 0m 0s 0S |
... die erste Millisekunde des aktuellen Kalendertags |
END_TODAY |
Ende heute |
23h 59m 59s 999S |
... die letzte Millisekunde des aktuellen Kalendertags |
START_TOMORROW |
Anfang des nächsten Tages |
0h 0m 0s 0S +1d |
.... die erste Millisekunde des nächsten Kalendertags (+1d) |
END_TOMORROW |
Ende des nächsten Tages |
23h 59m 59s 999S +1d |
... die letzte Millisekunde des nächsten Kalendertags (+1d) |
START_YESTERDAY |
Start des vorherigen Tages |
0h 0m 0s 0S -1d |
... die erste Millisekunde des vorherigen Kalendertags (-1d) |
END_YESTERDAY |
Ende des vorherigen Tages |
23h 59m 59s 999S -1d |
... die letzte Millisekunde des vorherigen Kalendertags (-1d) |
Kalenderwoche (Periode) |
|||
START_THIS_WEEK |
Anfang der Woche |
0h 0m 0s 0S 1E |
... die erste Millisekunde des ersten Tags der Woche (1E) |
END_THIS_WEEK |
Ende der Woche |
23h 59m 59s 999S 7E |
... die letzte Millisekunde des letzten Tags der Woche (7E). |
START_LAST_WEEK |
Anfang vergangene Woche |
0h 0m 0s 0S -7d 1E |
... die erste Millisekunde des ersten Tags (1E) der vorherigen Woche (-7d) |
END_LAST_WEEK |
Ende vergangene Woche |
23h 59m 59s 999S -7d 7E |
... die letzte Millisekunde des letzten Tags (7E) der vorherigen Woche (-7d) |
START_NEXT_WEEK |
Anfang nächste Woche |
0h 0m 0s 0S +7d 1E |
... die erste Millisekunde des ersten Tags (1E) der nächsten Woche (+7d) |
END_NEXT_WEEK |
Ende nächste Woche |
23h 59m 59s 999S +7d 7E |
... die letzte Millisekunde des letzten Tags (7E) der nächsten Woche (+7d) |
Kalendermonat (Periode) |
|||
START_THIS_MONTH |
Anfang des Monats |
0h 0m 0s 0S 1d |
... die erste Millisekunde des ersten Tags des aktuellen Monats (1d) |
END_THIS_MONTH |
Ende des Monats |
23h 59m 59s 999S 1d +1M 0d |
... die letzte Millisekunde des Tags vor dem ersten Tag (0d) des nächsten Monats (+1M) ►ANMERKUNG◄ Wegen der variablen Anzahl der Tage je Monat muss zum ersten Tag (1d) des aktuellen Monats gesprungen werden, um danach den Ersten des Folgemonats (+1M) anzusteuern. Von dort adressiert 0d (oder alternativ -1d) den vorherigen Kalendertag. |
START_LAST_MONTH |
Anfang vergangenen Monats |
0h 0m 0s 0S 1d -1M |
... die erste Millisekunde des ersten Tags (1d) des vorherigen Monats (-1M) |
END_LAST_MONTH |
Ende vergangenen Monats |
23h 59m 59s 999S 0d |
... die letzte Millisekunde des Tags vor dem ersten Tag (0d) des aktuellen Monats |
START_NEXT_MONTH |
Anfang nächsten Monats |
0h 0m 0s 0S 1d +1M |
... die erste Millisekunde des ersten Tags (1d) des nächsten Monats (-1M) |
END_LAST_MONTH |
Ende nächsten Monats |
23h 59m 59s 999S 1d +2M 0d |
... die letzte Millisekunde des Tags vor dem ersten Tag (0d) des übernächsten Monats (+2M) ►ANMERKUNG◄ Wegen der variablen Anzahl der Tage je Monat muss zum ersten Tag (1d) des aktuellen Monats gesprungen werden, um danach den Ersten des übernächsten Monats (+2M) anzusteuern. Von dort adressiert 0d (oder alternativ -1d) den vorherigen Kalendertag. |
Kalenderjahr (Periode) |
|||
START_THIS_YEAR |
Anfang des Jahres |
0h 0m 0s 0S 1d 1M |
... die erste Millisekunde des ersten Tags des aktuellen Jahres (1d 1M) |
END_THIS_YEAR |
Ende des Jahres |
23h 59m 59s 999S 12M 31d |
... die letzte Millisekunde des letzten Tags des aktuellen Jahres (12M 31d) |
START_LAST_YEAR |
Anfang letzten Jahres |
0h 0m 0s 0S 1d 1M -1y |
... die erste Millisekunde des ersten Tags des Jahres (1d 1M) im vorherigen Jahr (-1y) |
END_LAST_YEAR |
Ende letzten Jahres |
23h 59m 59s 999S 12M 31d -1y |
... die letzte Millisekunde des letzten Tags des Jahres (12M 31d) im vorherigen Jahr (-1y) |
START_NEXT_YEAR |
Anfang nächsten Jahres |
0h 0m 0s 0S 1d 1M +1y |
... die erste Millisekunde des ersten Tags des Jahres (1d 1M) im nächsten Jahr (+1y) |
END_NEXT_YEAR |
Ende nächsten Jahres |
23h 59m 59s 999S 12M 31d +1y |
... die letzte Millisekunde des letzten Tags des Jahres (12M 31d) im nächsten Jahr (+1y) |
Quartal (Periode) |
|||
START_THIS_QUARTER |
Anfang des Quartals |
0h 0m 0s 0S +0q |
... die erste Millisekunde des ersten Tags des aktuellen Quartals (+0q) |
END_THIS_QUARTER |
Ende des Quartals |
23h 59m 59s 999S +0Q |
... die letzte Millisekunde des letzten Tags des aktuellen Quartals (+0Q) |
START_LAST_QUARTER |
Anfang des letzten Quartals |
0h 0m 0s 0S -1q |
... die erste Millisekunde des ersten Tags des vorherigen Quartals (-1q) |
END_LAST_QUARTER |
Ende des letzten Quartals |
23h 59m 59s 999S -1Q |
... die letzte Millisekunde des letzten Tags des vorherigen Quartals (-1Q) |
START_NEXT_QUARTER |
Anfang des nächsten Quartals |
0h 0m 0s 0S +1q |
... die erste Millisekunde des ersten Tags des nächsten Quartals (+1q) |
END_NEXT_QUARTER |
Ende des nächsten Quartals |
23h 59m 59s 999S +1Q |
... die letzte Millisekunde des letzten Tags des nächsten Quartals (+1Q) |
Besondere Zeitpunkte |
|||
IN_THE_PAST |
In der Vergangenheit |
0y 1M 1d 0H 0m 0s 0S |
... erste Millisekunde ersten Tags des Jahres 0 (0y 1M 1d) |
IN_THE_FUTURE |
In der Zukunft |
9999y 12M 31d 23H 59m 59s 999S |
... letzte Millisekunde des letzten Tags des Jahres (9999y 12M 31d) |
Frei definierbar |
|||
CUSTOM |
Benutzerdefiniert |
<leer> |
... ermöglicht die Definition eines "benutzerdefinierten" Ausdrucks über den Parameter "Zeitwert" im Wertauflöser Relatives Datum mit Zeit |
Bei Bedarf können eigene "Zeittypen" mit einem spezifischem Ausdruck hinzugefügt oder ggf. auch bestehende entfernt werden.
ACHTUNG
Der Ausdruck für vordefinierte Einträge kann grundsätzlich editiert und so nach eigenen Vorstellungen angepasst werden. Allerdings betrifft jede Änderung an einem vordefinierten Ausdruck unmittelbar und global alle existierenden Referenzen, z. B. auch wenn im Kontext der Such API der Relatives Datum mit Zeit-Wertauflöser in Kriterien verwendet wird. Das kann weitreichende Konsequenzen für das Laufzeitverhalten von Lobster Data Platform / Orchestration sowie alle Lobster_data-Profile haben, die die Such API verwenden. Es ist daher ggf. ratsam, vom Standard abweichende Definitionen für die Berechnungslogik eigens hinzugefügten Werten zuzuordnen. Dann besteht je Referenz die Auswahl zwischen dem "werksseitigen Standard" und einem "eigenen Standard". Bei Bedarf kann über Dynamische Aufzählungsfilter diese Auswahl z. B. abhängig von Zuordnungskriterien eingeschränkt werden.