convertDateTime()

mixed convertDateTime(mixed dateTime, [string formatDateTime], [string formatSpecificaton])

The function convertDateTime() converts a date or a timestamp into a different date or timestamp.

• dateTime
  A Unix timestamp (e.g. 1418045461) or a string describing a date and/or a time (e.g. 8.12.2014 14:31').
• formatDateTime (optional)
  • Not specified or null – automatically interprets the dateTime, as long as the usual date and time notation follows. For example, “1.4.”, “4/1/2014”, “16:30”, “1.4.2014 16:30”.
  • Definition of formatting according to procedure in PHP DateTime::createFromFormat() (e.g. 'd.m.Y H:i')
• formatSpecification (optional)
  • Not specified or null – returns a Unix timestamp.
  • Definition of formatting according to PHP function date() (z.B. 'd.m.Y H:i').

Der Befragte wurd in der offenen Texteingabe “AB01_01” um eine Datums- und Zeitangabe gebeten, wann er zuletzt ferngesehen hat. Diese Angabe sollte nach der Vorgabe “Stunde:Minute” (for den aktuellen Tag) oder “Tag.Monat Stunde:Minute” für frühere Tage erfolgen.

Der folgende PHP-Code wird auf der Seite nach Frage “AB01” ganz oben platziert. Falls die Eingabe nicht als gültige Datums-Zeit-Angabe interpretiert werden konnte, wird der Textbaustein “datum-fehler” angezeigt und die Frage mitts repeatPage() erneut anegezeigt.

if (convertDateTime(value('AB01_01')) == false) {
  text('datum-fehler');
  repeatPage();
}

Weiter hinten im Fragebogen soll dieses Datum nun im standardisierten Format “Tag.Monat.Jahr Stunde:Minute” angezeigt werden. Für die Anzeige wird in einer Frage der Platzhalter %datum% verwendet. Der folgende PHP-Code wird über der Frage (oder auch schon weiter vorne) platziert.

$eingabe = value('AB01_01');
$ausgabe = convertDateTime($eingabe, null, 'd.m.Y H:i');
replace('%datum%', $ausgabe);