Datumsformatmuster

Zusammenfassung

Felder vom Typ DATUM unterstützen mehrere Eingabeformate. Standardmäßig werden zwei Formate erkannt:

1. ISO-8601 (z. B., 2025-06-30T15:00:00Z)
2. UNIX-Zeitstempel in Millisekunden (z. B., 1730342400000)

Ab Version 3.0, können Sie ein benutzerdefiniertes Datumsmuster für ein DATUM Feld definieren, wenn Ihre Daten ein anderes Format als die oben genannten Standardformate verwenden. Dadurch kann das FactFinder-System Datumsangaben während des Datenimports.

Das benutzerdefinierte Datumsmuster muss dem Standard Java-Datumsformatmuster (wie in den folgenden Abschnitten beschrieben) entsprechen.

Wichtig: Benutzerdefinierte Muster werden nur zum Parsen importierter Daten verwendet. Unabhängig vom Eingabeformat werden alle Datumsangaben von der REST-API zurückgegeben und im Cockpit in ISO-8601-Format.

Datumsangaben

Datumsformatmuster werden mithilfe einer Abfolge von Kodierungssymbolendefiniert, die jeweils Komponenten wie Jahr, Monat und Tag darstellen. In diesem Abschnitt erläutern wir, wie Muster erstellt werden, die diese Elemente enthalten.

Best Practice: Fügen Sie immer ein Zeitzonenformat in Ihr Datumsmuster ein und stellen Sie sicher, dass jeder Datumswert eine Zeitzoneenthält. Dies hilft, Mehrdeutigkeiten zu vermeiden und ein konsistentes Parsen über verschiedene Systeme hinweg sicherzustellen. Weitere Details finden Sie im Abschnitt mit dem Titel „Zeitzone“.

Hinweis: Wenn ein angegebener Datumswert nur das Datum (Jahr, Monat, Tag) enthält und die Uhrzeit auslässt, nimmt das System automatisch eine Uhrzeit von 00:00 Uhr (Mitternacht)an. Um unbeabsichtigtes Verhalten zu vermeiden, empfehlen wir, immer eine Zeitkomponente einzuschließen in Ihren Datumswerten.

Einheit	Symbol	Gültige Werte
Jahr	yy	letzte 2 Ziffern eines Jahres im Bereich von 2000 bis 2099
	yyyy	4 Ziffern eines Jahres
Monat	M	1 bis 12 sowie 01 bis 12
Monat (Name, auf Englisch)	MMM	3-Buchstaben-Code, z. B. Jan, Feb, ...
	MMMM	vollständiger Name
Tag (des Monats)	d	1 bis 31 sowie 01 bis 31
Tag (der Woche, auf Englisch)	eee	Mo bis So
	eeee	Montag bis Sonntag

Häufige Beispiele für Datumsangaben:

Vollständiges Muster	Beispiel-Datumswert
yyyy M d	1999 3 22
yyyy MMMM d	2022 March 22
d MMM yy	1 Jan 22
eee d M yyyy	Tue 22 3 2006
eeee d MMMM yyyy	Tuesday 22 March 2006
d.M.yyyy	22.8.1999
yyyy.M.d	1999.03.22
yyyy. M. d.	2033. 3. 22.
d-M-yyyy	22-03-2010
M-d-yy	3-22-10
yyyy-M-d	1999-03-22
M/d/yy	3/22/10
d. MMMM yyyy	22. March 2001
MMMM d, yyyy	March 22, 2041

Uhrzeit

Die Werte von DATUM Feldern stellen immer einen bestimmten Zeitpunktdar. Wenn ein Wert keine Zeitinformationenenthält, wird er so interpretiert, dass er sich auf den Beginn des Tages (d. h., 00:00:00) bezieht. Um Zeitinformationen explizit anzugeben, können Sie entweder das 24-Stunden- Format (z. B., 14:30) oder das 12-Stunden- Format mit einem AM/PM-Kennzeichen (z. B., 02:30 PM).

Hinweis: Wenn ein Teil der Zeit – etwa Stunde, Minuteoder Sekunde– ausgelassen wird, ist der Standardwert 0. Zum Beispiel wird 2025-06-30 interpretiert als 2025-06-30T00:00:00.

---

24-Stunden-Format

Einheit	Symbol	Gültige Werte
Stunde des Tages	H	0 bis 23 sowie 00 bis 23
Minute	m	0 bis 59 sowie 00 bis 59
Sekunde	s	0 bis 59 sowie 00 bis 59
Sekunde	ss	00 bis 59
Sekunde einschließlich Millisekunden	ss.SSS	00.000 bis 59.999

Häufige Beispiele für das 24-Stunden-Format:

Vollständiges Muster	Beispiel-Datumswert
d.M.yyyy H:m z	22.03.2020 13:37 CET
d.M.yyyy H:m s z	22.03.2020 13:37:05 CET
d.M.yyyy H:m z	22.03.2020 13.37 UTC
d.M.yyyy H:mss SSS z	22.11.2022 15:57:06.539 CET

---

12-Stunden-Format

Einheit	Symbol	Gültige Werte
Stunde von AM/PM	K	0–11 (wobei 0:00 AM gleich 0:00 und 0:00 PM gleich 12:00 ist)
Minute	m	0 bis 59 sowie 00 bis 59
Sekunde	s	0 bis 59 sowie 00 bis 59
Sekunde	ss	00 bis 59
Sekunde einschließlich Millisekunden	ss.SSS	00.000 bis 59.999
am/pm	a	AM oder PM

Häufige Beispiele für das 12-Stunden-Format:

Vollständiges Muster	AM-Beispiel	PM-Beispiel
d.M.yyyy K:m a z	22.03.1999 8:15 AM UTC	22.03.1999 08:15 PM UTC
d.M.yyyy K:m s a z	22.03.1999 08:15:00 AM UTC	22.03.1999 10:22:13 PM UTC

Zeitzone

FactFinder konvertiert jeden angegebenen Datumswert in die Zeitzone des Servers auf dem es gehostet wird. Diese Serverzeitzone wird in allen Datumswerten widergespiegelt, die zurückgegeben oder angezeigt werden von FactFinder, da sie gemäß dem ISO-8601 Standard formatiert werden.

Wenn ein Datumswert keine Zeitzoneninformationen enthält, interpretiert FactFinder ihn anhand der Standardzeitzone des Servers.

Empfehlung: Fügen Sie immer ein Zeitzone in Ihren Datumswerten, um konsistente und vorhersehbare Ergebnisse sicherzustellen. Das Weglassen der Zeitzone kann zu unerwartetem Verhalten führen, insbesondere über verschiedene Bereitstellungen oder Umgebungen hinweg.

Sie können Zeitzoneninformationen in einem Datumsmuster mithilfe der folgenden Symbole angeben:

Einheit	Symbol	Gültige Werte (Beispiele)
Zeitzonen-ID	VV	Europe/Berlin; Europe/Lisbon
Zeitzonenname	z	PST; UTC; CET
	zzzz	Pacific Standard Time; Universal Coordinated Time
Zeitzonenversatz	X	Z; +00; -08
	XXXX	Z; -0830; +083015
	XXXXX	Z; 08:30; +08:30:15
Zeitzonenversatz (auf Englisch)	O	GMT; GMT+8; GMT-08:00

Beispiele:

Vollständiges Muster	Beispielwert	Resultierendes ISO-8601 (bei Hosting in Deutschland)
d.M.yyyy H:mXXXX	30.08.2022 08:15+0200	2022-08-30T08:15:00+02:00
d.M.yyyy H:m O	22.02.2022 08:15 GMT+2	2022-02-22T07:15:00+01:00
d.M.yyyy H:m z	22.02.2022 05:06 PDT	2022-02-22T14:06:00+01:00
d.M.yyyy H:m z	22.02.2022 05:06 CET	2022-02-22T05:06:00+01:00
d.M.yyyy H:m zzzz	22.02.2022 05:06 Universal Coordinated Time	2022-02-22T06:06:00+01:00

---

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

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

Wie oben erwähnt, werden Datumsangaben ohne eine angegebene Uhrzeit 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 betreffenden Tages in dieser Zeitzone. FactFinder NG Wenn eine Zeitzone explizit angegeben wird, wird der Wert so verstanden, dass er den Beginn des angegebenen Tages in dieser bestimmten Zeitzonedarstellt. FactFinder NG behandelt dies konsistent als einen festen Zeitpunkt, unabhängig davon, wo er verarbeitet wird.

| Beispielwert | Beginn des Tages in: | Resultierendes ISO-8601 (bei Hosting in Deutschland) | | 30.08.2022 | Hosting-Standort, d. h. Berlin | 2022-08-30T00:00:00+02:00 | | 30.08.2022+0100 | London | 2022-08-30T01:00:00+02:00 | | 30.08.2022+0300 | Moskau | 2022-08-29T23:00:00+02:00 |

Freitext

Alle Buchstaben A bis Z und a bis z sind reservierte Mustersymbole. Jedes Nicht-Buchstabenzeichen außer '[', ']', '{', '}', '#' und dem einfachen Anführungszeichen wird unverändert geparst.

Sie können Buchstaben maskieren indem Sie sie in einfache Anführungszeichen einschließen (') wenn Sie sie in Freitext verwenden möchten. Verwenden Sie ein einfaches Anführungszeichen, um ein einfaches Anführungszeichen zu maskieren ('').

Beispiele:

Vollständiges Muster	Beispiel-Datumswert
d. MMM ''yy z	22. Jan '99 UTC
'Export date:' yyyy M d z	Exportdatum: 1999 03 22 UTC
d'x'M'x'yyyy’x’z	22x3x1999xUTC
d.M.yyyy H'h'm z	22.03.1999 13h37 CET
d.M.yyyy 'at' H:m z	22.03.1999 at 13:37 CET
d.M.yyyy H 'o''clock' z	22.03.1999 5 o'clock UTC