Configuring the basic settings for a Date time control - a date or time
Select a property for a Date time control to determine the dates and times that the application users can select. Set related options to specify the label, default value, helper text, and field visibility for the control.
- Click the control, and then click the View properties icon.
- On the General tab, set the Type parameter to Date.
- In the Property field, press the Down Arrow key, and then select
a property whose value you want the user to choose from at run time.
- To review a property, in the Property field press the Down Arrow key, select a property from the list and click the Open icon.
- To create a new property, in the Property field enter the new property name, and click the Open icon.
- Optional: To make data entry faster, in the Default value field, enter a
default entry.You can enter a constant value, a property reference, or an expression for a user form or a flow action form that is displayed in read-write mode.
- Optional: To specify instructional text or hints within the calendar control field, in the
Placeholder field, select one of the following settings:
- To display the localized Date time format for this control, select Expected format.
- To display instructional text within the calendar control field, select
Other.
In the field below, press the Down Arrow key to select existing, preset text.
Click the Open icon to enter a new instruction or hint.
- Optional: To describe the control's purpose to users at run time, in the Helper
text field, select one of the following settings:
- To display the text next to the calendar field, select Always visible / In-line.
- To add an icon to a control with a text displayed when the user hovers over the
icon, selectHelp icon with overlay on hover.
In the field below, press the Down Arrow key to select existing, preset text.
Click the Open icon to enter a new instruction or hint.
- To display the text when the user hovers over the field, select Tooltip
(not recommended).
In the field below, press the Down Arrow key to select existing, preset text.
Click the Open icon to enter a new instruction or hint.
- In the Visibility field, choose when you want to display the
property value:
- To display the field or hide it, based on the property value at the time that this section or flow action is first presented or refreshed select Always, If not blank, or Not zero.
- To make the visibility dependent on an expression, select Condition
(expression).
In the field below, press the Down arrow key to select a condition.
Click the Open condition builder icon.
- To make the visibility dependent on a when rule, select Condition (when
rule).
In the field below, press the Down Arrow key to select a when rule.
Click the Open icon to create a new one.
- In the Disable field, specify when the control is not available
to users:
- To disable the text input, select Always.
- To disable the text input under the specified condition, select
Condition (expression). In the field that is displayed, select
a condition or click the Open condition builder icon.
You can define a simple expression based on the comparison of a pair of constants, properties, or both.
- To disable the text input under the specified when condition, select Condition (when). In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
- Optional: To specify when the users have to enter a value for this field to save the form, in the
Required field, select one of the following settings:
- To make the field always required, select Always.
At run time, the field is marked with an orange asterisk.
- To make the field required under the specified condition, select
Condition (expression). In the field that is displayed, select
a condition or click the Open condition builder icon.
You can define a simple expression based on the comparison of a pair of constants, properties, or both.
- To make the field required under the when condition, select Condition (when). In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
- To make the field always required, select Always.
- Click Submit.
- Specifying read-only and edit options for a Date time control
Edit options determine when a control is editable or read-only for the application's users.
- Selecting the date and time format and display mode
You can specify which date and time element selectors are displayed on the form at run time. For example, you can display a calendar widget with a corresponding text input field or display drop-down fields for selecting the month, day, and year.
- Selecting spinners or drop-down fields for navigation
You can specify whether your application users select dates and times with spinner controls or drop-down fields.
- Restricting the years displayed
To make it easier for users to select valid dates, you can restrict the number of years that are displayed relative to, and including, the current date. At run time, only values that fall within the range of dates that you specify are visible on the calendar widget or available by using spinners or drop-down fields.
- Setting intervals of minutes
By default, the time picker displays minutes from 0 through 59. To restrict the time selections available to users, you can configure your application to display intervals of minutes on time controls, instead.
- Displaying week numbers in calendar widgets
If users are accustomed to seeing week numbers in calendars, you can specify that the week numbers are displayed along the left side of the calendar widget in your application. The week numbers are shown according to the ISO 8601 standard date notation. Week numbers may vary, depending on locale.
- Disabling the selection of weekend days
To make it easier for users to select valid dates, you can disable weekend dates so that users cannot select them in your application. Weekend (non-working) dates can be based on the user's calendar or on another business calendar.
- Specifying presentation options for a Date time control
You can specify how read-only dates or date and time combinations are displayed in your application. For example, you might specify that the year comes first, or that months are spelled out rather than represented numerically.
- Specifying a time zone for a Date time control
To enable users to enter a specific date and time in the calendar picker, change the default time settings to a particular time zone.
Previous topic Adding a Date time control to a layout Next topic Specifying read-only and edit options for a Date time control