# DateFormatProcessor

## Überblick

Der `DateFormatProcessor` formatiert Datums- und Zeitwerte in Templates mit benutzerdefinierten Formaten.

## Funktionsweise

- Findet Tags mit `date-format`-Attribut
- Formatiert den Inhalt des Tags oder den angegebenen Wert nach dem gewünschten Format
- Ersetzt den Inhalt des Tags mit dem formatierten Datum

## Syntax

```html
<span date-format="format" [date-value="value"]>fallbackValue</span>
```

## Parameter

- **date-format**: (Erforderlich) Das Format für die Datumsausgabe (PHP date()-Format)
- **date-value**: (Optional) Der zu formatierende Wert, falls nicht angegeben wird der Inhalt des Tags verwendet

## Beispiele

```html
<!-- Aktuelles Datum formatieren -->
<span date-format="d.m.Y">Aktuelles Datum</span>

<!-- Spezifischen Zeitstempel formatieren -->
<span date-format="d.m.Y H:i" date-value="2023-12-31 23:59:59">31.12.2023</span>

<!-- Variable aus dem RenderContext formatieren -->
<span date-format="d.m.Y H:i" date-value="{{ createdAt }}">Erstelldatum</span>
```

## Unterstützte Eingabeformate

Der Prozessor kann verschiedene Eingabeformate verarbeiten:

- Unix-Zeitstempel (als Zahl)
- ISO 8601 Datum-/Zeitstring (z.B. "2023-12-31T23:59:59")
- Natürliche Sprachausdrücke (z.B. "next Monday")
- DateTime-Objekte (wenn im RenderContext vorhanden)

## Ausgabeformatierung

Die Formatierung erfolgt mittels PHP's `date()`-Funktion. Die wichtigsten Formatierungszeichen sind:

- **d**: Tag des Monats (01-31)
- **m**: Monat (01-12)
- **Y**: Jahr (vierstellig)
- **H**: Stunde im 24-Stunden-Format (00-23)
- **i**: Minuten (00-59)
- **s**: Sekunden (00-59)

## Localization

Für eine lokalisierte Datumsausgabe kann der Prozessor mit der IntlDateFormatter-Klasse erweitert werden, um sprachspezifische Formatierungen zu unterstützen.

## Tipps

- Verwenden Sie für konsistente Datumsformatierung im gesamten Template
- Kann mit dem PlaceholderReplacer kombiniert werden, um dynamische Datumswerte zu formatieren
- Nützlich für Blogs, Ereignislisten und alle zeitbezogenen Darstellungen
