# Datumsformatmuster

## **Zusammenfassung**

Felder des Typs `DATUM` unterstützen mehrere Eingabeformate. Standardmäßig werden zwei Formate erkannt:

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

Ab Version **3.0**, können Sie ein **benutzerdefiniertes Datumsformat** für ein `DATUM` Feld definieren, wenn Ihre Daten ein anderes Format als die oben genannten Standardformate verwenden. Dies ermöglicht dem FactFinder-System, Datumsangaben während des **Datenimports**.

> Das benutzerdefinierte Datumsformat muss den standardmäßigen **Java-Datumsformatmustern** entsprechen (wie in den folgenden Abschnitten beschrieben).

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

## **Datumsangaben**

Datumsformatmuster werden unter Verwendung einer Sequenz von **Kodierungssymbolen**, wobei jedes ein Element wie Jahr, Monat und Tag darstellt. In diesem Abschnitt erklären wir, wie Muster konstruiert werden, die diese Elemente enthalten.

> **Beste Praxis:** Fügen Sie immer ein **Zeitzonenformat** in Ihr Datumsformat ein und stellen Sie sicher, dass jeder Datumswert eine **Zeitzone**. Dies hilft, Mehrdeutigkeiten zu vermeiden und gewährleistet ein konsistentes Parsen über Systeme hinweg.\
> 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 Zeit weglässt**, nimmt das System automatisch eine Zeit von **00:00 (Mitternacht)**. 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 2000 bis 2099 |
|                            | yyyy   | 4-stellige Jahresangabe                                |
| Monat                      | M      | 1 bis 12 sowie 01 bis 12                               |
| Monat (Name, auf Englisch) | MMM    | 3-Buchstaben-Code, z. B. Jan, Feb, ...                 |
|                            | MMMM   | voller Name                                            |
| Tag (des Monats)           | d      | 1 bis 31 sowie 01 bis 31                               |
| Wochentag (auf Englisch)   | eee    | Mon bis Sun                                            |
|                            | eeee   | Monday bis Sunday                                      |

> Häufige Beispiele für Datumsangaben:

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

## **Zeit**

Die Werte von `DATUM` Feldern stellen immer einen **konkreten Zeitpunkt dar**. Wenn ein Wert keine **Zeitangaben**enthält, wird er so interpretiert, dass er sich auf den **Beginn des Tages** (d. h., `00:00:00`). Um explizit Zeitangaben bereitzustellen, 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 — wie z. B. **Stunde**, **Minute**, oder **Sekunde**— fehlt, wird dieser standardmäßig auf `0`gesetzt.\
> Zum Beispiel, `2025-06-30` wird 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 inkl. Millisekunden | ss.SSS | 00.000 bis 59.999        |

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

| Vollständiges Muster  | Beispieldatum               |
| --------------------- | --------------------------- |
| 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:m:ss.SSS z | 22.11.2022 15:57:06.539 CET |

***

### 12-Stunden-Format

| Einheit                     | Symbol | Gültige Werte                                                 |
| --------------------------- | ------ | ------------------------------------------------------------- |
| Stunde im AM/PM-Zyklus      | 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 inkl. 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 spiegelt sich in allen Datumswerten wider, **die von FactFinder zurückgegeben oder angezeigt werden,** da sie mit dem **ISO-8601** Standard formatiert werden.

Wenn ein Datumswert **keine Zeitzoneninformationen enthält**, wird er von FactFinder unter Verwendung der **Standardzeitzone des Servers**.

> **Empfehlung:** Fügen Sie immer ein **Zeitzone** in Ihren Datumswerten anzugeben, um konsistente und vorhersehbare Ergebnisse sicherzustellen. Das Weglassen der Zeitzone kann zu unerwartetem Verhalten führen, insbesondere bei unterschiedlichen Deployments oder Umgebungen.

Sie können Zeitzoneninformationen in einem Datumsformat 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 |
| Zeitzonenoffset               | X      | Z; +00; -08                                       |
|                               | XXXX   | Z; -0830; +083015                                 |
|                               | XXXXX  | Z; 08:30; +08:30:15                               |
| Zeitzonenoffset (in Englisch) | O      | GMT; GMT+8; GMT-08:00                             |

> Beispiele:

| Vollständiges Muster | Beispielwert                                | Resultierendes ISO-8601 (angenommen in Deutschland gehostet) |
| -------------------- | ------------------------------------------- | ------------------------------------------------------------ |
| 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       | <p>22.02.2022 05:06 CET<br></p>             | 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: Zeit nicht angegeben, aber Zeitzone angegeben (nicht empfohlen!)

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

Wie oben erwähnt, werden Datumsangaben ohne eine spezifizierte Zeit 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 angegebenen Tages in dieser Zeitzone. FactFinder NG Wenn eine **Zeitzone explizit angegeben ist**, wird der Wert so verstanden, dass er den **Beginn des angegebenen Tages in dieser spezifischen Zeitzone darstellt**. FactFinder NG wird dies konsequent als einen **festen Zeitpunkt**behandeln, unabhängig davon, wo er verarbeitet wird.

\| Beispielwert | Beginn des Tages in: | Resultierendes ISO-8601 (angenommen in Deutschland gehostet) | | 30.08.2022 | Hosting-Standort z. B. 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-Buchstaben-Zeichen, außer `'[', ']', '{', '}', '#'` und dem einfachen Anführungszeichen, wird unverändert geparst.

Sie können **Buchstaben maskieren** indem Sie sie mit einfachen Anführungszeichen umgeben `(')` wenn Sie sie im Freitext verwenden möchten. Verwenden Sie ein einfaches Anführungszeichen, um ein einfaches Anführungszeichen zu maskieren `('')`.

> Beispiele:

| Vollständiges Muster      | Beispieldatum               |
| ------------------------- | --------------------------- |
| d. MMM ''yy z             | 22. Jan '99 UTC             |
| 'Exportdatum:' 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: 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:

```
GET https://docs.fact-finder.com/docs/de/basic-settings/fields/date-format-patterns.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.