> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/docs/de/basic-settings/fields/date-format-patterns.md).
# 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 **Kodierungssymbolen**definiert, 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 **Zeitzone**enthä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 Zeitpunkt**dar. Wenn ein Wert keine **Zeitinformationen**enthä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**, **Minute**oder **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 Zeitzone**darstellt. 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 |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fact-finder.com/docs/de/basic-settings/fields/date-format-patterns.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.