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).

images/download/attachments/113281548/image2022-9-6_10-2-40-version-1-modificationdate-1662451361039-api-v2.png

Werksseitig sind folgende Definitionen für Standardwerte vorbelegt:

Name

Lokalisierung (Deutsch)

Ausdruck
(Syntax s. Relatives Datum mit Zeit)

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)
"Beginn der Zeitrechnung"

IN_THE_FUTURE

In der Zukunft

9999y 12M 31d 23H 59m 59s 999S

... letzte Millisekunde des letzten Tags des Jahres (9999y 12M 31d)
"Ende der Zeitrechnung"

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.

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg ACHTUNGimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg 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.