Logo Docs
Logo Docs

@DATE_QUESTION

Specifies that a variable expects to receive a date and customize how to ask for the value.

Before generating a document, DocuMold will display a date picker to select the date.

Usage

<# @DATE_QUESTION(variable, **see parameters below**) #>

Parameters

variable

(Required) The variable this applies to. Do not use double quotes (") around it, just write it as a usage of the variable.
example_value:

(Named) The initial value in the form when preparing a template (via “Prepare a template”). Must be a date. If not given, the value of initial_value is used.
help_text:

(Named) Displays a clickable (?) bubble beside the label. Clicking it will reveal this text. Useful to give directions to the user of the DocuMold template.
initial_value:

(Named) The initial value in the form when using a template (via “Use a template”). Must be a date. This is also the default value of the example_value parameter.
label:

(Named) The text to display beside the date picker that asks for the value. Defaults to variable’s name.
optional:

(Named) Set this to TRUE to allow the user to leave the date empty (value would then be NOTHING)

Parameters with “Named” mean that you must specify the name of the parameter and a colon before its value. Ex: example_value: "its value"

Examples

Example Result

<# @DATE_QUESTION(birth_date, label: “Birth date of the participant”) #>

<# @DATE_QUESTION(birth_date, example_value: DATE(2024, 02, 07)) #>

<# @DATE_QUESTION(birth_date, initial_value: DATEVALUE(“2024-02-07”)) #>

More information

The value in the variable will be a date, not a text. This means it’s possible to use date-related functions with this variable without needing to convert.

If no value is entered in the form for this question, the variable will be set to NOTHING.

This action does nothing to the document itself; it gets erased when generating a document.

All @..._QUESTION actions are normally placed at the end of the template to avoid overwhelming unfamiliar users.

The @IF action has no effect on the @...QUESTION actions. The @...QUESTION actions have an effect even when they is hidden.

See also