Formatierungsmuster für den Feldtyp Datum

Die Werte von Feldern des Typs DATE können auf verschiedene Weise formatiert werden. Standardmäßig erkennt FACT-Finder zwei Datumsformate: ISO-8601 Datumsangaben und UNIX Zeitstempel (in Millisekunden).

Wenn die gelieferten Werte eines Datumsfeldes nicht gemäß ISO-8601 oder entsprechend einem Zeitstempel in Millisekunden formatiert sind, kann ab der Version NG 3.0 ein Muster, das dieses Format beschreibt, auf dem entsprechenden Feld definiert werden. FACT-Finder erkennt dann zusätzlich zu den beiden Standard-Datumsformaten auch dieses konfigurierte dritte Format.

Um korrekt zu funktionieren, muss das konfigurierte Muster mit den Spezifikationen der Datumsformatmuster in den folgenden Abschnitten übereinstimmen.

Bitte beachten Sie, dass das konfigurierte Muster ausschließlich zum Parsen der Datumswerte beim Datenimport verwendet wird. Datumsangaben, die von der REST-API zurückgegeben oder im Cockpit in der FACT-Finder UI angezeigt werden, sind immer im ISO-8601-Format formatiert.

Datum

Das Formatierungsmuster für ein Datum basiert auf einer Folge von Formatierungssymbolen. In diesem Abschnitt wird, beschrieben, wie Sie ein Muster für Datumsformate mit Jahr, Monat und Tag definieren können.

Wir empfehlen Ihnen dringend, in jedes Datumsformat ein Zeitzonenformat und in jeden Datumswert eine Zeitzone aufzunehmen. Weitere Informationen zu diesem Thema finden Sie im Abschnitt "Zeitzone" weiter unten.

Bitte beachten Sie, dass Werte für den Datentyp DATE, die ein Datum, aber keine Uhrzeit enthalten, implizit immer die Uhrzeit 0:00 Uhr enthalten. Wir raten Ihnen daher, immer auch eine Uhrzeit in den übergebenen Wert aufzunehmen.

Beispiele:

Zeit

Die Werte von Datumsfeldern in FACT-Finder stellen immer einen bestimmten Zeitpunkt dar. Wenn die Werte nur ein Datum aber keine Zeitangabe enthalten, werden sie als Tagesbeginn angesehen.

Für Zeitangaben kann entweder das 24-Stunden-Format oder das 12-Stunden-Format verwendet werden. Bei fehlenden Informationen über den Wert von Stunde, Minute und/oder Sekunde wird hier ein Wert von 0 angenommen.

24-Stunden-Format:

Beispiele für das 24-Stunden-Format:

12-Stunden-Format:

Beispiele für das 12-Stunden-Format:

Zeitzone

FACT-Finder rechnet jeden Datumswert in die Zeitzone des Servers um, auf dem er gehostet wird.
Die Zeitzone des Servers ist in jedem von FACT-Finder zurückgegebenen oder angezeigten Datum zu finden, da diese immer nach ISO-8601 formatiert sind.

Enthält ein Datumswert keine Information über die Zeitzone, interpretiert FACT-Finder das Datum mit der Zeitzone des Servers, auf dem FACT-Finder läuft. Wir empfehlen daher, immer die Zeitzone anzugeben. Ohne Angabe der Zeitzone sind die Ergebnisse weniger vorhersehbar.

Die Zeitzone kann im Muster mit den folgenden Symbolen angegeben werden:

Beispiele:

Sonderfall: die Uhrzeit wird nicht angegeben, aber die Zeitzone wird angegeben (nicht empfohlen!):

Wenn Datumsangaben keine Informationen über ihre Zeitzone enthalten, werden sie in der Zeitzone des Hosting-Servers interpretiert (siehe 1. Beispiel weiter unten).

Wie bereits erwähnt, werden Datumsangaben ohne Zeitangabe so interpretiert, dass sie sich auf den Beginn des Tages beziehen. Durch die Angabe der Zeitzone bezieht sich der angegebene Wert auf den Beginn des jeweiligen Tages in dieser Zeitzone. FACT-Finder bezieht sich dann immer auf genau diesen Zeitpunkt. Bitte beachten Sie jedoch, dass der Tag im resultierenden ISO-8601-Datum aufgrund von Zeitunterschieden zwischen dem Hosting-Standort und der angegebenen Zeitzone von dem angegebenen Wert abweichen kann (siehe 3. Beispiel unten).

Freier Text

Alle Buchstaben A bis Z und a bis z sind reservierte Mustersymbole. Alle Zeichen, die keine Buchstaben sind, außer '[', ']', '{', '}', '#' und dem einfachen Anführungszeichen, werden so geparst, wie sie sind. Sie können Buchstaben maskieren, indem Sie sie mit einfachen Anführungszeichen (') umgeben, wenn Sie sie in freiem Text verwenden wollen. Verwenden Sie ein einfaches Anführungszeichen, um ein einfaches Anführungszeichen ('') zu maskieren.

Beispiele: