Der Kalender ermöglicht es ein bestimmtes Datum auszuwählen. Es stehen verschiedene Konfigurations-Einstellungen zur Verfügung um eine Auswahl des Datums zu begrenzen.
Konfiguration
Um einen Kalender zu bekommen, wird ein neues Feld in der Datenmodellierung benötigt, welches als Typ "Datumsauswahl" hat. Folgende Konfigurationen sind möglich.
| Info | ||
|---|---|---|
| ||
Alle Werte müssen in einem bestimmten Schema angegeben werden. Hier wird der heutige Tag als "01.01.1970" angesehen. Somit kann der z.B. das Minimal-Datum für den gestrigen Tag mit "-02.01.1970" gesetzt werden. Das Datum "02.01.1970" bedeutet 1 Tag und in dem Fall das "-", subtrahiere den Wert nach dem Minus vom heutigen Tag (ein "+" ist ebenfalls möglich). |
...
Diese Option ist der Standard-Wert des Kalenders. Wird der Kalender geöffnet und ist noch kein Datum gewählt, wird dieser Wert vorausgewählt, Beispiel: "12.11.2019"
...
Verwendung
Dieses Feld kann z.B. im Shop für die Registrierung als Geburtstag verwendet werden. Hierzu gibt man die zu wählende Zeitspanne an, um Anwender in einem bestimmten Alter zuzulassen.
Beispiel
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
dateDefault: '-01.01.1988'
dateMax: '-01.01.1988'
dateMin: '-31.12.2068'
yearStart: 1920
yearEnd: 2001
whitelist: shopRegister
|
Bei diesem Beispiel bekommt man folgendes Resultat (Screenshot von Zeitpunkt: 12.11.2019):
...
Mit der Datums- und Zeitauswahl in brandbox kann ein Datum, eine Uhrzeit oder eine Kombination aus Datum und Uhrzeit ausgewählt werden. In der Datenmodellierung steht dieses Eingabefeld in seinen drei Verwendungsoptionen zur Verfügung.
Suche nach relativen Angaben
Im Suchfilter von brandbox stehen bei der Datums- und Zeitauswahl auch Suchoptionen für relative Zeit- und Datumsangaben zur Verfügung. Hierbei wird im Suchfilter keine Auswahl sondern ein einfaches Eingabefeld angeboten welches die Eingabe eines bestimmten Formates etwartet. Dieses Format wird unter https://www.php.net/manual/de/datetime.formats.relative.php genauer beschrieben. Nachfolgend ein paar Beispiele für dieses Format:
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
-2 days |
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
-2 days -4 hours -30 minutes |
Konfiguration
Die Datums- uns Zeitauswahl kann über zusätzliche Konfigurationsoptionen angepasst werden. Die nachfolgende Konfiguration kann über die Feldkonfiguration der Datenmodellierung oder den Konfiguration in den Widget- und Strukturdefinition platziert werden:
| Codeblock | ||||
|---|---|---|---|---|
| ||||
{
"InputDateOptions": {
"minDate": "01-01-2022",
"maxDate": "31-12-2022"
// Weitere Optionen unter https://xdsoft.net/jqplugins/datetimepicker/#lazyInit
}
} |