8 Fragen zu Datepicker

Das `<p:datePicker>`-Tag wird von **PrimeFaces** ab der Version **8.0** unterstützt. In dieser Version wurde der neue DatePicker als moderner Ersatz für das ältere `<p:calendar>`-Tag eingeführt. Weitere Informationen findest du in der [PrimeFaces 8.0 Release Notes](https://www.primefaces.org/blog/primefaces-8-0-released/) und in der [offiziellen Dokumentation](https://www.primefaces.org/showcase/ui/input/datepicker.xhtml).

Wenn bei deinemFaces DatePicker Uhrzeit nicht einstellbar ist, liegt das in der Regel daran, dass das Attribut `showTime` nicht gesetzt oder auf `false` steht. Standardmäßig zeigt der DatePicker nur das Datum an. Um die Uhrzeit auswählen zu können, musst du das Attribut `showTime="true"` setzen. Beispiel: ```xml <pdatePicker value="#{bean.date}" showTime="true" /> ``` Weitere mögliche Ursachen: 1. **Veraltete PrimeFaces-Version:** Ältere Versionen unterstützen eventuell die Zeitauswahl nicht oder haben Bugs. Prüfe, ob du eine aktuelle Version verwendest: [PrimeFaces Download](https://www.primefaces.org/downloads/). 2. **Falscher Komponententyp:** Es gibt sowohl `<p:calendar>` (älter, deprecated) als auch `<p:datePicker>`. Die Zeitauswahl funktioniert bei beiden, aber die Konfiguration unterscheidet sich leicht. 3. **Formatierung:** Stelle sicher, dass das Attribut `pattern` oder `dateFormat` auch die Zeit enthält, z.B. `pattern="dd.MM.yyyy HH:mm"`. 4. **Eingeschränkte Properties:** Manche Themes oder eigene CSS-Anpassungen können die Anzeige der Zeitauswahl unterdrücken. **Zusammenfassung:** Setze `showTime="true"` und prüfe ggf. das Datums-/Zeitformat. Beispiel: ```xml <p:datePicker value="#{bean.date}" showTime="true" pattern="dd.MM.yyyy HH:mm" /> ``` Weitere Infos findest du in der [PrimeFaces DatePicker Dokumentation](https://www.primefaces.org/showcase/ui/input/datepicker.xhtml).

Der PrimeFaces DatePicker unterstützt die Auswahl von Uhrzeit (Time Selection) ab Version **8.0**. In dieser Version wurde das neue DatePicker-Component eingeführt, das sowohl Datum als auch Uhrzeit (über das Attribut `showTime="true"`) unterstützt. Weitere Informationen findest du in der [PrimeFaces 8.0 Release Notes](https://www.primefaces.org/blog/primefaces-8-0-released/) und in der [offiziellen Dokumentation zum DatePicker](https://www.primefaces.org/showcase/ui/input/datepicker.xhtml).

Das Problem, dass der PrimeFaces DatePicker trotz `locale="de"` weiterhin englische Monats- und Tagesnamen anzeigt, tritt häufig auf, wenn die benötigten Lokalisierungsdateien für die gewünschte Sprache (hier Deutsch) nicht korrekt eingebunden oder geladen werden. **Mögliche Ursachen und Lösungen:** 1. **Fehlende JavaScript-Lokalisierungsdatei:** PrimeFaces verwendet für die Lokalisierung des DatePickers (insbesondere bei der jQuery UI-Variante) separate JavaScript-Dateien, z.B. `locales/datepicker-de.js`. Wenn diese Datei nicht eingebunden ist, bleibt die Anzeige auf Englisch. **Lösung:** Stelle sicher, dass die Datei `primefaces/locales/primefaces-locales.js` (oder bei älteren Versionen die passende jQuery UI Locale-Datei) in deiner Seite eingebunden ist. Beispiel: ```xml <h:outputScript name="primefaces/locales/primefaces-locales.js" library="primefaces" /> ``` 2. **Falsche oder fehlende Locale-Angabe:** Die Angabe `locale="de"` im DatePicker-Tag ist korrekt. Achte darauf, dass keine Tippfehler vorliegen und dass das Attribut auch wirklich gesetzt ist. Beispiel: ```xml <p:datePicker locale="de" ... /> ``` 3. **PrimeFaces-Version:** In neueren Versionen von PrimeFaces (ab 8.0) wird der DatePicker auf Basis von [Flatpickr](https://flatpickr.js.org/) umgesetzt. Hier ist die Lokalisierung bereits in der Bibliothek enthalten, aber auch hier muss ggf. die Lokalisierungsdatei geladen werden. **Lösung:** Prüfe, ob du eine aktuelle PrimeFaces-Version verwendest und ob ggf. ein Bug in der verwendeten Version vorliegt. Ein Update kann helfen. 4. **Browser-Cache:** Manchmal werden Änderungen an eingebundenen Skripten nicht sofort übernommen. Leere den Browser-Cache oder lade die Seite im Inkognito-Modus neu. 5. **Fehlende oder falsche Konfiguration in faces-config.xml:** In seltenen Fällen kann auch die Standard-Locale der JSF-Anwendung eine Rolle spielen. Prüfe, ob in deiner `faces-config.xml` die richtige Locale gesetzt ist: ```xml <application> <locale-config> <default-locale>de</default-locale> </locale-config> </application> ``` **Zusammenfassung:** Meistens liegt es an der fehlenden Einbindung der Lokalisierungsdatei. Prüfe, ob du die Datei `primefaces-locales.js` korrekt eingebunden hast. Weitere Infos findest du in der [PrimeFaces Dokumentation](https://primefaces.org/showcase/ui/input/datepicker/localization.xhtml). **Links:** - [PrimeFaces DatePicker Localization](https://primefaces.org/showcase/ui/input/datepicker/localization.xhtml) - [PrimeFaces Dokumentation](https://primefaces.org/documentation/) Falls das Problem weiterhin besteht, prüfe die Browser-Konsole auf Fehlermeldungen bezüglich fehlender Skripte.

Im Standardverhalten zeigt der PrimeFaces DatePicker keine Kalenderwoche an, weil diese Funktion nicht automatisch aktiviert ist. Die Anzeige der Kalenderwoche (meist als "KW" oder "Week Number" bezeichnet) muss explizit konfiguriert werden. **Lösung:** Du kannst die Kalenderwochen im DatePicker anzeigen lassen, indem du das Attribut `showWeek` auf `true` setzt: ```xml <p:datePicker showWeek="true" /> ``` **Wichtige Hinweise:** - Die Kalenderwochen werden nur im **Popup-Modus** angezeigt, nicht im Inline-Modus. - Die Anzeige der Kalenderwoche ist ab PrimeFaces 8.0 verfügbar. Bei älteren Versionen gibt es diese Option nicht. - Die Darstellung kann je nach Theme und Lokalisierung unterschiedlich sein. **Weitere Infos:** Offizielle Dokumentation: [PrimeFaces DatePicker Dokumentation](https://www.primefaces.org/showcase/ui/input/datepicker/basic.xhtml) Falls du eine bestimmte Version von PrimeFaces nutzt, prüfe bitte, ob das Attribut `showWeek` dort unterstützt wird.

In PrimeFaces Version 8 wird die Eigenschaft **showWeek** beim **DatePicker**-Komponenten **nicht** unterstützt. Die Option **showWeek** (zur Anzeige der Kalenderwochen) ist erst mit der Einführung des neuen DatePicker-Komponenten in PrimeFaces 10 hinzugekommen. In PrimeFaces 8 basiert der DatePicker noch auf jQuery UI Datepicker, und dort ist die Option **showWeek** zwar im jQuery UI Datepicker vorhanden, aber PrimeFaces 8 hat diese Option nicht als Attribut in der eigenen DatePicker-Komponente verfügbar gemacht. **Fazit:** In PrimeFaces 8 kannst du die Kalenderwochen im DatePicker nicht direkt über ein Attribut wie `showWeek="true"` anzeigen lassen. Diese Funktion steht erst ab PrimeFaces 10 zur Verfügung. Weitere Informationen: - [PrimeFaces 8.0 User Guide – DatePicker](https://primefaces.github.io/primefaces/8_0/#/components/datepicker) - [PrimeFaces 10.0 DatePicker – showWeek](https://primefaces.github.io/primefaces/10_0/#/components/datepicker) **Tipp:** Falls du Kalenderwochen in PrimeFaces 8 benötigst, müsstest du auf eigene Lösungen oder Workarounds zurückgreifen, z.B. durch Anpassung des jQuery UI Datepickers per JavaScript.

Um den PrimeFaces DatePicker in Version 8 auf Deutsch einzustellen, gibt es zwei gängige Wege: **1. Über die `web.xml` (globale Einstellung):** Füge in deiner `web.xml` (im Verzeichnis `src/main/webapp/WEB-INF/`) folgende Zeile: ```xml<context-param> <param-name>primefaces.LOCALE</param-name> <param-value>de</param-value> </context-param> ``` Dadurch wird die Sprache für alle PrimeFaces-Komponenten auf Deutsch gesetzt. --- **2. Direkt im DatePicker-Tag (lokale Einstellung):** Du kannst die Sprache auch direkt im DatePicker-Tag setzen: ```xml <p:datePicker value="#{bean.date}" locale="de" /> ``` --- **Zusätzlicher Hinweis:** Stelle sicher, dass die deutsche Übersetzung in deiner PrimeFaces-Version enthalten ist. In der Regel ist das ab Werk der Fall. **Dateipositionen:** - Die `web.xml` liegt im Verzeichnis: `src/main/webapp/WEB-INF/` - Die JSF-Seite mit dem DatePicker liegt meist unter: `src/main/webapp/` (z.B. `index.xhtml`) **Weitere Infos:** [PrimeFaces Dokumentation](https://primefaces.org/documentation/v8.0/input/datepicker.html) Damit wird der DatePicker auf Deutsch angezeigt.

Das Problem, dass beim PrimeFaces DatePicker trotz gesetzter Locale (z.B. `locale="de"`) und entsprechender Einstellung in der `web.xml` weiterhin englische Bezeichnungen angezeigt werden, tritt häufig auf und hat meist folgende Ursachen: 1. **Fehlende oder falsche PrimeFaces-Resource-Bund:** Faces bringt eigene Lokierungsdateien die DatePickerponente mit. Wenn diese nicht korrekt eingebunden oder nicht vorhanden sind, wird auf Englisch zurückgegriffen. 2. **Locale-Attribut überschreibt globale Einstellungen:** Die Einstellung in der `web.xml` (z.B. `<locale-config>`) legt die Standard-Locale für die JSF-Anwendung fest. Das Attribut `locale="de"` am DatePicker-Tag sollte dies eigentlich überschreiben. Wenn aber z.B. ein Tippfehler vorliegt oder die Locale nicht korrekt erkannt wird, bleibt es bei Englisch. 3. **Fehlende oder falsche JavaScript-Übersetzungen:** Der DatePicker verwendet intern JavaScript für die Lokalisierung. Die deutschen Übersetzungen werden über eine JS-Datei geladen (`primefaces-locales.js`). Wenn diese Datei nicht geladen wird, bleibt die Sprache auf Englisch. **Lösungsansätze:** - **Prüfe, ob die PrimeFaces-Locale-Resource geladen wird:** Stelle sicher, dass die Datei `primefaces-locales.js` im Browser geladen wird. Das kannst du in den Entwicklertools (Netzwerk-Tab) überprüfen. - **Setze das Locale-Attribut korrekt:** ```xml <p:datePicker locale="de" ... /> ``` oder ```xml <p:datePicker value="#{bean.date}" locale="#{view.locale}" ... /> ``` - **Überprüfe die web.xml:** Die Einstellung in der `web.xml` sieht z.B. so aus: ```xml <locale-config> <default-locale>de</default-locale> </locale-config> ``` Diese Einstellung wirkt sich auf die gesamte Anwendung aus, aber das Attribut am Tag hat Vorrang. - **PrimeFaces-Version prüfen:** In älteren Versionen von PrimeFaces gab es Bugs bei der Lokalisierung des DatePickers. Stelle sicher, dass du eine aktuelle Version verwendest: [PrimeFaces Download](https://www.primefaces.org/downloads/) - **Eigene Übersetzungen setzen (optional):** Du kannst die Übersetzungen auch manuell setzen, falls es weiterhin Probleme gibt: ```xml <p:datePicker ... > <f:attribute name="monthNames" value="Januar,Februar,März,April,..." /> <f:attribute name="dayNamesMin" value="So,Mo,Di,Mi,Do,Fr,Sa" /> ... </p:datePicker> ``` **Zusammenfassung:** Meist liegt es daran, dass die JavaScript-Lokalisierungsdatei nicht geladen wird oder das Locale-Attribut nicht korrekt gesetzt ist. Prüfe diese Punkte und aktualisiere ggf. PrimeFaces. Weitere Infos findest du in der [PrimeFaces-Dokumentation](https://primefaces.org/showcase/ui/input/datepicker/localization.xhtml).