Universitäts­rechen­zentrum
Datumsauswahl in Formularen

Datumsauswahl in Formularen

  1. Nutzung
  2. Beispiele
    1. generelle Verwendung
    2. barrierefreie Verwendung

Mit Hilfe des TUCAL-Datepickers lässt sich eine Datumsauswahl leicht realisieren. Um ein Eingabefeld, welches die Datumsauswahl entsprechend anzeigt muss dafür zunächst die Datei php/datepicker.inc am Seitenanfang geladen werden: 

<?php
    …
    # Nutzung des Datepicker-Moduls
    require_once('php/datepicker.inc');
    seite(__FILE__);
?>

Sicherheit

Es sollte beachtet werden, dass die Datumsauswahl lediglich eine alternative Eingabe zur Verfügung stellt. Der Nutzer kann weiterhin jeden beliebigen Inhalt in das Formular einfügen. Nutzereingaben sollten immer serverseitig überprüft werden.

Nutzung

Ausgabe kann mit echo datepicker($settings) erfolgen. Folgende Parameter können im $settings-Array definiert werden:

value Initialer Wert des Inputs (value) als String. Muss im selben Format angegeben werden wie eingestellt.
date_format Datumsformat als String, es können Kombinationen aus folgenden Zeichen übergeben werden:
  • d: Tag des Monats ohne führende Null
  • dd: Tag des Monats als zweistellige Zahl
  • o: Tag des Jahres ohne führende Null
  • oo: Tag des Jahres als dreistellige Zahl
  • D: kurzer Name des Tages
  • DD: Name des Tages
  • m: Monat des Jahres ohne führende Null
  • mm: Monat des Jahres als zweistellige Zahl
  • M: kurzer Name des Monats
  • MM: Name des Monats
  • y: Jahr als zweistellige Zahl
  • yy: Jahr als vierstellige Zahl
  • '...': Text
  • '': einfaches Anführungszeichen
Standard: dd.mm.yy
input_class CSS-Klasse des eingefügten <input>-Elements als String; Standardmäßig form-control
input_id ID des eingefügten <input>-Elements als String
input_name name-Attribut des eingefügten <input>-Elements als String
required Ob das eingefügte <input>-Element ausgefüllt werden muss (Boolean); Standard true

Beispiele

generelle Verwendung

<?php

echo datepicker(
    array(
        "date_format" => "DD, 'dem' d.m.yy",
        "value" => "Mittwoch, dem 3.7.2019",
        "required" => false
    )
);

?>

barrierefreie Verwendung

Um eine Beschreibung für das Eingabefeld bereitzustellen kann ein <label>-Element verwendet werden. Dieses wird über die festgelegte ID dem Eingabefeld zugewiesen. Die Beschreibung sollte den Zweck und das gewünschte Format des Eingabefelds enthalten. 

<label for="dpExample">Gewünschtes Datum (im Format dd/mm/yyyy):</label>
<?php

echo datepicker(
    array(
        "date_format" => "dd/mm/yy",
        "input_id" => "dpExample"
    )
);

?>

TUCaktuell