{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5235,"path":"conversational-interfaces/virtual-agent/va-date-time-input.md","title":"Date Time user input control","bundle":null,"doc_type":null,"release":"australia","body":"\n# Date Time user input control\n\nUse the Date Time user input control in a Virtual Agent topic to enable the user to select a calendar date, time \\(hours and minutes\\), or both.\n\n## Date Time user input control properties for LLM topic discovery\n\nThe Date Time user input control accepts inputs from a calendar selection, or by entering plain language in the Virtual Agent chat window. If you type your answer, the Virtual Agent accepts different inputs depending on how your region handles dates. For example, if you're in the United States, the input control supports the MM-DD-YYYY format, while a user in Spain enters the date in DD-MM-YYYY format.\n\n<table id=\"table_m2v_xmj_h1c\"><thead><tr><th>\n\nDate Time property\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nName that identifies this node in the topic flow.\n\n</td></tr><tr><td>\n\nVariable Name\n\n</td><td>\n\nName of the variable that stores the user response to this prompt. The variable name is automatically created from the **Node name** property.\n\n</td></tr><tr><td>\n\nAllow automatic slot-filling\n\n</td><td>\n\nToggle to allow this node’s value to be automatically set by other nodes, as well as during topic discovery. When this toggle is activated, the Detail description field changes from dynamic Data Pill Picker and script options to a static text field.\n\n</td></tr><tr><td>\n\nDetail description\n\n</td><td>\n\nDescription of the information that you need from users. If the **Allow automatic slot filling** toggle is deactivated, you can create a dynamic detail description by selecting the Data Pill Picker icon \\[Omitted image \"variable-reference-picker.png\"\\] Alt text: to define conditions, or select the Open Editor icon \\[Omitted image \"icon-script.png\"\\] Alt text: to enter a script. If the **Allow automatic slot filling** toggle is activated, you can only enter a static description.\n\n \\[Omitted image \"LLM-input-discoverable-toggle.png\"\\] Alt text: When the Allow automatic slot-filling toggle is inactive, the detail description includes Data Pill Picker and script dynamic options. When the toggle is active, the Detail description field becomes static.\n\n</td></tr><tr><td>\n\nInput format\n\n</td><td>\n\nType of Date Time control to be displayed. Select one of the following formats:\n\n-   **Date**: Shows only the monthly calendar for the user to select the date.\n-   **DateTime**: Shows both a monthly calendar and time picker.\n-   **Time**: Shows only the time picker for the user to select the time \\(hours and minutes\\).\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td>\n\nEnforce user prompt\n\n</td><td>\n\nToggle to open a field for a custom message shown to the user instead of the message generated by the large language model \\(LLM\\). You can create custom messages in plain language, input a script, or define conditions with the data pill picker.\n\n</td></tr><tr><td>\n\nValidation\n\n</td><td>\n\nAdd a script to validate the user input. For example, check if the user entered a valid email address.\n\n</td></tr><tr><td>\n\nAdditional instructions for LLM\n\n</td><td>\n\nFurther instructions to the LLM, such as adding data formats, restrictions, or default values for user responses. You can create additional instructions in plain language, input a script, or define conditions with the data pill picker.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide or skip this node\n\n</td></tr><tr><td>\n\nConditionally show this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n</td></tr><tr><td>\n\nAllow user to skip this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.\n\n If users enter a value such as `skip this step` when the conditions do not allow skipping, they receive a message saying the node cannot be skipped and are re-prompted to provide an answer.\n\n</td></tr></tbody>\n</table>## Example Date Time user input control for LLM topic discovery\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n<table id=\"table_u5s_lfr_11c\"><thead><tr><th>\n\nInput properties\n\n</th><th>\n\nDate Time prompt\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-date-time-llm-3.png\"\\] Alt text: All basic Date Time user input fields are openly available. Select any of the advanced options to toggle them open individually.\n\n</td><td>\n\n\\[Omitted image \"va-datetime-native.png\"\\] Alt text: In the Web client, a calendar pop-up lets the user choose a date and time.\n\n</td></tr></tbody>\n</table>## Date Time user input control properties for NLU topic discovery\n\n<table id=\"table_nff_y1b_3db\"><thead><tr><th>\n\nDate Time property\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nName that identifies this node in the topic flow.\n\n</td></tr><tr><td>\n\nVariable Name\n\n</td><td>\n\nName of the variable that stores the user response to this prompt. The variable name is automatically created from the **Node name** property.\n\n</td></tr><tr><td>\n\nPrompt\n\n</td><td>\n\nPrompt or question for the user. The prompt can be either a text string or a script that returns text. This value is used only when the default value is not specified. For example: `What's your name?`\n\n</td></tr><tr><td>\n\nNLU entity\\[NLU topic discovery only\\]\n\n</td><td>\n\nOption to associate an NLU entity with the node. If an NLU entity is associated with the input variable for this node, Virtual Agent can slot-fill the specified value based on the user's utterance. Select an entity from the list of entities associated with the topic intent.\n\n When you specify an entity for the node, the Do not ask users to confirm recognized entity toggle switch is displayed. When enabled, users are not prompted to confirm the extracted entity.\n\n</td></tr><tr><td>\n\nInput format\n\n</td><td>\n\nType of Date Time control to be displayed. Select one of the following formats:\n\n-   **Date**: Shows only the monthly calendar for the user to select the date.\n-   **DateTime**: Shows both a monthly calendar and time picker.\n-   **Time**: Shows only the time picker for the user to select the time \\(hours and minutes\\).\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nDefault value\n\n</td></tr><tr><td>\n\nPredefine a value for user input\n\n</td><td>\n\nPredefined value for the user response to the question or prompt. The response defined in the **Default value confirmation** field asks the user to confirm the default value. If the user responds with `no`, the value becomes null. The default value can be either a text string or a script that returns text. For example, if you're using dot-walking, the default value might be: `Script Variables > Last username`. Or if you're using a script, the default value might be: `{{vaScripts.lastUsername}}`.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nConfirmation messages\n\n</td></tr><tr><td>\n\nInput completion confirmation\n\n</td><td>\n\nBot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: `Thanks, (Input Variables > Username)!` Or if you're using a script, the acknowledgement might be: `Thanks, {{vaInputs.username}}!`\n\n</td></tr><tr><td>\n\nDefault value confirmation\n\n</td><td>\n\nMessage that asks the user to verify that the value in the **Default value** field is correct. This message is used instead of a value in the **Prompt** field. It can contain either a text string or a script that returns text. For example, if you're using dot-walking: `Are you (Input Variables > Username)?` Or if you're using a script, the confirmation message might be: `Are you {{vaScripts.lastUsername}}?`.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nConversation switching\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nThis section is available only when NLU discovery is enabled on the instance.\n\n</td></tr><tr><td>\n\nTurn on to let users change the subject\n\n</td><td>\n\nOption to enable NLU prediction for this node. If enabled, users can enter text to answer questions, regardless of the type of input control being used. Virtual Agent uses this utterance to match another existing intent, letting the user switch topics.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide or skip this node\n\n</td></tr><tr><td>\n\nConditionally show this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n</td></tr><tr><td>\n\nAllow user to skip this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.\n\n</td></tr><tr><td>\n\nSkip reprompting if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip reprompting in the conversation. When a preceding node is revisited through a topic loopback or Dialog Act, Virtual Agent bypasses this node and automatically retains its original value.\n\n</td></tr></tbody>\n</table>## Example Date Time user input control for NLU topic discovery\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n<table id=\"table_f1f_v2p_xdb\"><thead><tr><th>\n\nInput properties\n\n</th><th>\n\nDate Time prompt\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-datetime-properties.png\"\\] Alt text: Basic properties include the node name, prompt, input format, and NLU entity.\n\n</td><td>\n\n\\[Omitted image \"va-datetime-native.png\"\\] Alt text: In the Web client, a calendar pop-up lets the user choose a date and time.\n\n</td></tr></tbody>\n</table>## Channel support\n\n<table id=\"table_akv_2xp_rsb\"><thead><tr><th>\n\nChannel\n\n</th><th>\n\nLLM support\n\n</th><th>\n\nNLU/keyword support\n\n</th><th>\n\nConstraints\n\n</th></tr></thead><tbody><tr><td>\n\nWeb UI\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nMobile UI\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nServiceNow Otto panel\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nMicrosoft Teams\n\n</td><td>\n\nSupported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nSlack\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nWorkplace\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nThe Workplace interface does not natively support a date selection widget. Date and time selection is instead done with the buttons that are supported in these interfaces.\n\n The Date Time user input control prompts the user for a date, showing the current date and time. The user selects the month, day, year, or time button to modify that value. The time and day fields prompt the user to type in a new value. The month and year fields show a set of buttons with the current and upcoming months or years. Select one of these buttons or type in a value to set the time or year.\n\n</td></tr><tr><td>\n\nFacebook Messenger\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nIf your administrator has set the option to request the time zone from the customer, the selected date and time reflect the customer's time zone. Otherwise, they appear in the UTC time zone. For more information about the time zone setting, see [Set up Conversational Integration with Facebook Messenger](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/messg-fbm-setup.md).\n\n</td></tr><tr><td>\n\nSMS Twilio\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNot supported\n\n</td><td>\n\nNot applicable\n\n</td></tr><tr><td>\n\nLINE\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nWhatsApp\n\n</td><td>\n\nSupported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nApple Messages for Business\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nNone\n\n</td></tr><tr><td>\n\nAlexa \\(Voice\\)\n\n</td><td>\n\nNot Supported\n\n</td><td>\n\nSupported\n\n</td><td>\n\nFor best results, enable NLU at the node.\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Assistant Designer user input controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-user-inputs.md)\n\n"}}