Actions

Question type - Date/nl: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
No edit summary
Line 32: Line 32:
{{QS:dropdown_dates_year_max/nl}}
{{QS:dropdown_dates_year_max/nl}}


{{QS:date_min}}
{{QS:date_min/nl}}


{{QS:date_max}}
{{QS:date_max}}

Revision as of 18:29, 25 January 2014

Korte beschrijving

This question type can be used to ask for a certain date, for a time or a combination of date and time. Dates and times can be entered directly, chosen from a popup calendar or from drop-down boxes. For validation, minimum and maximum dates can be chosen. Various date and time formats are supported. Some of these features are only available from LimeSurvey version 2.05+.

Hoofd instellingen

Verplicht (mandatory)

Beschrijving

Met deze optie kan de enquête-beheerder instellen dat een bepaalde vraag beantwoordt moet worden voordat de deelnemer verder kan gaan met invullen. Als je een vraag hebt met subvragen en je wilt niet alle onderdelen verplicht maken, gebruik dan de optie Minimum aantal antwoorden (min_answers) op de tab Logica.

Als je een van de vooraf geïnstalleerde thema's gebruikt en het attribuut verplicht is ingeschakeld, wordt er naast de vraag een rood sterretje weergegeven. Als je het sterretje wilt verbergen, lees dan deze beschrijving.


Beschikbare opties

  • Aan - Vraag moet worden beantwoord voordat de deelnemer naar de volgende pagina kan - de antwoordoptie 'Geen antwoord' wordt nooit getoond.
  • Zacht - Als de vraag niet wordt beantwoord, wordt een waarschuwing weergegeven wanneer wordt geprobeerd door te gaan naar de volgende pagina - de deelnemer kan er echter voor kiezen de waarschuwing te negeren en verder te gaan. Merk op dat de optie 'Geen antwoord' nog steeds wordt weergegeven (indien geactiveerd in de instellingen voor enquêtepresentatie)
  • Uit (standaard) - Vraag kan onbeantwoord blijven


Conditie (eerder "Relevantievergelijking")

Beschrijving

Als de waarde van de conditie 1 of true is dan is de vraag relevant en wordt de vraag getoond bij het invullen van de enquête. En anders niet. Bij elke vraag kun je een relevantievergelijking specificeren. Dit vervangt de condities, het ondersteunt veel meer complexe logica.

Syntax markering in kleur

Wanneer je de conditie opslaat, dan wordt het geëvalueerd en met kleur gemarkeerd. De fouten worden met een kleur aangegeven waardoor je de fouten gemakkelijker ziet,

 Hint: Om de condities in je enquête te controleren gebruik je de functie toon logica enquête.


Geldige waarden

  • Een conditie gebruikt de syntax die beschreven is in ExpressionScript, zonder de omringende accolades.

Voorbeelden

Voorbeelden van het met kleur markeren, oftewel syntax markering.


Speciale instellingen

Omgekeerde antwoordvolgorde (reverse)

Beschrijving

Indien geactiveerd worden de antwoordopties in de omgekeerde volgorde getoond.

Beschikbare opties

  • Ja
  • Nee (standaard)

Voorbeeld

Een voorbeeld met een vraag met het vraagtype Array (getallen). Indien de optie is uitgeschakeld (standaardwaarde) dan zijn de antwoorden: "1, 2, 3, ... , 10". Indien ingeschakeld zijn de beschikbare antwoorden: "10, 9, 8, ... , 1".



Randomisatiegroepsnaam (random_group)

Beschrijving

Plaatst de vragen in een randomisatiegroep waardoor de vragen in een willekeurige volgorde getoond worden aan de deelnemers.

Een voorbeeld van een enquête met deze functie staat hier.

Geldige waarden

Geef een tekst op (bijvoorbeeld: 'groep1'). Alle vragen die deze tekst bij dit veld hebben krijgen onderling een willekeurige plaats.


Preview Als je een voorbeeld van de vragen wilt bekijken, gebruik dan het voorvertonen van de enquête in plaats van die van de vragengroep, omdat van de tweede is gemeld dat deze de vragen niet in een willekeurige volgorde zou weergeven.



Toon dropdownvelden datum (dropdown_dates)

Beschrijving

Indien ingeschakeld wijzig je de presentatie van het datum vraagtype naar dropdownvelden voor dag/maand/jaar in plaats van de standaard popup.

Beschikbare opties

  • Aan
  • Uit (standaard)

Voorbeeld

Indien ingeschakeld, de vraag wordt getoond als:



Deze vraag altijd verbergen (hidden)

Beschrijving

Indien ingeschakeld wordt de vraag altijd verborgen voor de deelnemers aan de enquête. Je kunt dit gebruiken als:

  • je met een URL een vraag al ingevuld toont, dan kun je met deze instelling voor zorgen dat de vraag helemaal niet getoond wordt aan de deelnemer. Deze instelling gaat voor wat met condities is ingesteld, de vraag wordt helemaal niet opgenomen op de pagina.
  • je een even snel een waarde wilt bepalen of opslaan met ExpressionScript.
NB: Deze functie wordt vaak gebruikt bij het vraagtype vergelijking.

Beschikbare opties

  • Aan
  • Uit (standaard)



Minimum jaar (dropdown_dates_year_min)

Beschrijving

Met dit vraagattribuut kun je het minimum jaar instellen voor het datum vraagtype. Geldt zowel voor de weergave van de datum in dropdown velden als voor de weergave als kalender.

Geldige waarden

Elk jaar



Maximum jaar (dropdown_dates_year_max)

Beschrijving

Met dit vraagattribuut kun je het maximum jaar instellen voor het datum vraagtype. Geldt zowel voor de weergave van de datum in dropdown velden als voor de weergave als kalender.

Geldige waarden

Elk jaar



Minumum datum (date_min)

Beschrijving

Dit vraagattribuut kan gebruikt worden om een minimale waarde voor de datum te bepalen voor een vraag met een kalender (formaat y-m-d of een Engelse tekst). Het geldt zowel voor de popup-variant als voor de dropdownlijsten. De defaultwaarde is 1 januari 1900.


  Attentie : De validatie-optie Expressie beheer kan ook worden gebruikt voor het bepalen van een minimum datum. Als je echter de pop-up kalender gebruikt en de expressie is afhankelijk van een vraag op dezelfde pagina wordt het jaar niet goed weergegeven.



Geldige waarden

  • Elke datum in het formaat YYYY-MM-DD (bijv., 2017-08-24)
  • Elke waarde voor jaar
  • Een Engelse tekst : "now", "-10 years", "tomorrow"
  • Referentie aan een andere datum/tijd vraag (bijv., geboortedatum, met de vraagcode)
  • Expressies, met expressies kun je dynamisch een startdatum bepalen. Voorbeeld: je kunt een datum van een vorige vraag gebruiken + 3 dagen als het minimum voor de huidige vraag, door: date("Y-m-d",strtotime(vertrekdatum)+3*60*60*24).



Maximum date (date_max)

Description

This question attribute can be used to set the maximum value for the date question (in y-m-d format or any other English valid string - see below for more options). It can be used for both popup and dropdown display options.

  Attention : The Expression Manager validation option can also be used for setting up a "maximum date". However, if you use the popup calendar and the expression relies on a previous question located on the same page, the year will not be displayed correctly in the popup calendar.


Valid values

  • Any date value in format YYYY-MM-DD (eg., 2018-08-24);
  • Any year value;
  • Any English string : "now", "-10 years", "tomorrow";
  • Reference to another date/time question : AnotherDateQuestion (using the question code);
  • Expressions: With expressions, a date can be dynamically calculated. For example, you can use a date from a previous answer + 3 days as a maximum date for the present question by entering: date("Y-m-d",strtotime(departuredate)+3*60*60*24).



Date/Time format

Description

This question option can be used to specify a custom date format. If it is empty, the survey date format will be used.

Valid values

  • The d/dd,m/mm,yy/yyyy,H/HH,M/MM formats can be used to display the date and/or time, while "-", ".", "/", ":" can be used as separators.

Examples

  • yyyy-mm-dd - year-month-day;
  • dd.mm.yyyy HH:MM - day.month.year Hour:Minute;
  • HH:MM - Hour:Minute (only the time can be selected);
  • yyyy/mm - year/month.



Tip for whole question validation equation (em_validation_q_tip)

Description

If you are using the question validation equation, you can use this box in order to display an optional message as question tip on how the question has to be filled out.

Valid values

Example

See the example from the question validation equation wiki section- it shows how the tip can be tailored to show which parts of a multiple short text question fail the validation criteria.



Insert page break in printable view (page_break)

Description

This attribute is only active when you actually print a survey from the Printable View. It forces a page break before the question.

Available options

  • On
  • Off (default)


Dates and Expression Manager: Advanced validation and calculation

Limesurvey versions 2.05+ and above make it fairly easy to validate dates using the date_min and date_max fields (see above). Use these whenever possible. If you need to do more fancy stuff, you may be able to work (and calculate) with dates using Expression Manager and the function strtotime() (New in 2.0 build 130515). It calculates the number of seconds from the 1st January 1970 to a given date. Example: if you want to display in a question text the number of days that have passed since a departure date (asked in a previous question) and today, you can can use the expression {(strtotime("now")-strtotime(departure))/60/60/24}. Please be aware that strtotime() works with a lot of different but not ALL date formats. Limesurvey's default date format (MM-DD-YYYY) does NOT work with strtotime(). Please set your survey to use one of the following date formats to avoid problems: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY, DD-MM-YYYY.

  Dates in Limesurvey are saved as a string (text format).Starting in ver. 2.05+, Expression Manager converts all dates part of an expression into the standard format "yyyy-mm-dd HH:MM:SS". This makes it much easier to compare dates in an expression (e.g. "date1>date2"). If you need a datetring in the format it was asked in the question, use the ".shown" attribute (e.g.: "So you were born on the {birthdate.shown}. Is this right?"