====== caseTime() ======

''int **caseTime**(string //Seitenkennung//)''

Ermittelt die Verweildauer auf einer bestimmten Seite oder die Zeit, die der Teilnehmer bislang mit dem Interview verbracht hat. Die Zeit wird jeweils in Sekunden ermittelt.

  * //Seitenkennung//\\ Kennung der Seite, für welche die Verweildauer ermittelt werden soll () oder eine der nachfolgenden Spezialkennungen: '''previous''', '''this''', '''hitherto''', '''break''' oder '''begin'''. Falls eine Spezialkennung angegeben wird, liefert ''caseTime()'' die Verweildauer dafür und nicht die Verweildauer für eine eventuell gleichnamige Seite im Fragebogen.
    * //<[[:de:glossary#seitenkennung|Seitenkennung]]>// -- Kennung einer Seite im Fragebogen
    * '''previous''' -- Seite, die vor der aktuellen Seite abgefragt wurde.
    * '''this''' -- Die aktuelle Seite. Dieser Wert ist 0, falls die Seite das erste Mal angezeigt wird. Der Wert ist größer, falls die Seite wiederholt angezeigt wird, z.B. wegen fehlender Werte oder nach einer Unterbrechung.
    * '''hitherto''' -- Verweildauer auf allen Seiten, die der Teilnehmer vor der aktuellen Seite ausgefüllt hat.
    * '''begin''' -- Zeit, die seit Beginn des Interviews vergangen ist. Beachten Sie, dass dieser Wert auch ohne Verwendung des "Zurück"-Knopfes und der wiederholten Anzeige einer Seite vom //all//-Wert abweichen kann, da hier auch die Zeit enthalten ist, die der Server zur Verarbeitung und Erstellung der Seiten benötigt.
    * '''break''' -- Zeit, die vergangen ist, seitdem zuletzte eine Seite angezeigt wurde. Im normalen Interviewverlauf entspricht der Wert der Verweildauer auf der vorhergehenden Seite (''previous''). Falls die vorige Seite wiederholt angezeigt wurde, ist es die Zeit seit deren letzten Anzeige. Falls die aktuelle Seite wiederholt angezeigt wird (z.B. wegen unvollständiger Angaben oder weil das Interview unterbrochen wurde), ist es die Zeit seit der vorhergehenden Anzeige der Seite.

**Hinweis:** Falls ein Teilnehmer eine Seite mehrfach besucht (z.B. weil Antworten fehlten oder durch Verwendung des "Zurück"-Knopfes), werden die Verweildauern für die Seite addiert.

**Hinweis:** Wenn der Fragebogen mittels ''[[:de:create:functions:gotopage|goToPage()]]'' zu einer Seite springt, so wird die Verweildauer der Seite angerechnet, die zuerst angezeigt wurde. Wenn also auf der Seite "eins" ein Filter steht, der den Teilnehmer direkt weiter zu Seite "zwei" leitet, so wird die Verweildauer dennoch für Seite "eins" gespeichert.


===== Beispiel 1 =====

Falls der Teilnehmer weniger als 10 Sekunden für die vorhergehende Seite brauchte, zeigt der folgende PHP-Code diese erneut an -- zusammen mit dem Textbaustein "too_quick".

<code php>
if (caseTime('previous') < 10) {
  repeatPage('too_quick');
}
</code>


===== Beispiel 2 =====

Der folgende PHP-Code beginnt das Interview von vorne (__ohne__ die bisherigen Antworten zu löschen), falls der Teilnehmer für die bisherigen Seiten weniger als 1 Minute brauchte.

Dieses Beispiel setzt voraus, dass die erste Seite die [[:de:glossary#seitenkennung|Kennung]] "start" hat.

<code php>
if (caseTime('hitherto') < 60) {
  text('please_check'); // Hinweis-Text
  setNextPage('start'); // Nach dem "Weiter" zur Seite "start"
  pageStop(); // Keine weiteren Inhalte auf der Seite anzeigen
}
</code>