Date Picker
  • 17 May 2024
  • 6 Minutes to read
  • PDF

Date Picker

  • PDF

Article summary

Date Picker control allows users to input or select dates accurately and conveniently for choosing a single date or multiple or  defining a range of dates. This ensures a consistent user experience and standardizes date entry across forms, preventing invalid entries and format discrepancies.

A quick glance on the Date Picker in Form Control.

Figure: Date Picker Control by Application Designer

Figure: Date Picker Control by End User

User Persona:Application Designer

Let's explore the following use case:
Use Case
User Persona: Application Designer
Solution
In a Knowledge Management system at NovaTech, content administrators need to manage the lifecycle of knowledge articles, including setting expiry dates for articles to ensure that outdated or obsolete information is removed from public access.
To achieve this, Sam must drag and drop a date control labeled "Expiry Date" to the knowledge article form. Adds validations for the Expiry date to be 30 days more than the current date.

Configure Date Picker

To configure Date Picker, perform the following steps:

  1. Navigate to Form Designer > Form Control > Date Picker.

  2. Drag and drop the Date Picker control into the Form Designer Canvas.
    The Date Picker displayed on the Canvas.
    Figure: Date Picker Control

  3.  Mouse-over to the Date Picker control and click Setting icon.
    The configure properties screen is displayed.
    Figure: Configure Properties

  4.  Enter the required details as described in the following tab and click Save. 

Properties Tab

The Properties tab enables you to define controls and values of the calendar based on the requirement.

Figure: Properties Tab

Enter the appropriate values in the required fields. The following table provides a list of actions with description:

FieldDescription
General
Title *

Enter the unique name for the Date. This name identifies the Date control in the form.

For example: Valid from, End Date, Expiry date.

Sub TitleEnter the name for the Sub title that allows you to input text that will be displayed directly below the Title. It's useful for describing the function of the control or providing usage instructions.
Render As *Select from the drop-down to determine the behavior of the control.
  • Single - Enable you to select a single date from the calendar.
  • Multiple - Enables you to select multiple dates from the calendar.
  • Range - Enables you to select the range of dates from the calendar.
Format *Select the display format for the chosen date: either Date or Date Time.

Display based on logged in Users Time Zone

Enable this option to display selected date and time based logged-in user's time zone setting.
Information
Help TextProvide a help text that gives the end users guidance on how to fill out the field correctly.
For example, "Enter your name here.", "Enter a summary.
Rich TextSelect it to enable the help text as a rich text format. It allows formatting like bold, italic, color to the text, etc. for the help text.
TooltipAdd a tooltip that is displayed when the user hovers the mouse cursor over the long text field.

Advance

The list of advanced setups allows the Application Designer to configure additional date and time settings. This table presents the properties available in the Advanced section, along with their descriptions.

Note
This section is only displayed when "Date Time" format is selected in the properties.

Figure: Advance tab

Enter the appropriate values in the required fields. The following table provides a list of actions with description:

FieldDescription
Date Settings
Year NavigatorEnable the Year Navigator feature to enable customers to navigate through different years by clicking on the arrows.
Min YearSelect the earliest year available in the drop-down list.
Max YearSelect the latest year available in the drop-down list.
Month NavigatorEnable the Month Navigator to allow customers to navigate through different months by clicking on the arrows.
In LineEnable the toggle to view the calendar display style in the In-Line format. It displays in Float Type if the toggle is disabled.
Allow Selection of Past DateEnables you to select past dates (any day < current day).
Allow Future Dates SelectionEnables you to select past dates (any day > current day).
Disable DateSelect specific date(s) that customers should not be able to select.
Note
When a customer hovers over a disabled date, a message "Date Disabled" will be displayed.
Disable Days of WeekSelect the days of the week that customers should not be able to select.
Time Settings
Limit TimeSelect the time limit from the options provided:
  • AM Only: Customers can select times only in the morning. 
  • Only: Customers can select times only in the afternoon or evening. 
  • Both: Customers can select times throughout the day, both morning and afternoon/evening.
Step HourSelect the increment value for hours when using the arrow buttons to adjust the time.
Step MinuteSelect the increment value for minutes when using the arrow buttons to adjust the time.
Step Second

Select the increment value for seconds when using the arrow buttons to adjust the time

Validations

The Validations tab enables you to configure Calendar details. To know more about the fields that are available under the Validations section, see Field Description.

Figure: Validations

Select the Calendar Validation from the list to configure and click Done.

Appearance

The Appearance tab enables you to configure Icon, Text, and Label for Calendar.  To know more about the fields that are available under the Appearance section, see Field Description.

Figure: Appearance

The Appearance tab is divided into two sections:

Icon

Icon appearance settings allow users to customize the visual representation of icons used in the application. Users can adjust various attributes with their organization's branding or to improve visual clarity and accessibility.

Figure: Icon

FieldDescription
Icon
Icon LabelSelect the Icon Label from the list. The listed values are:
  • Float - Enhances the user experience by keeping labels visible even after the user has entered information.
  • Horizontal - It provide a more traditional form layout, which is preferred in certain design contexts.
  • Vertical - It provide a streamlined and compact form layout, particularly suitable for mobile devices.
Icon PositionSelect the position of the icon. The listed values are:
  • Left - It provides usability, and contributing to a more intuitive and user-friendly experience.
  • Right - Provides accessibility and ease of use when a particularly for tasks where users expect controls or options to be located on the right.
Label
Upload IconBrowse and select the label icon from the system. Click + Choose to select the icon and to upload.
Icon LabelSelect the Icon Label from the list. The listed values are:
  • Vertical
  • Horizontal
  • Float
Icon PositionSelect the position of the icon. The listed values are:
  • Left
  • Right

Text

Text appearance settings provide users with the ability to customize the visual characteristics of text displayed throughout the application. 

Figure: Text

FieldDescription
Font TypeSelect the specific font style used for displaying text within the application. It allow users to select from a selection of different font styles to customize the appearance of text throughout the application.
Font ColorSelect the color of the text displayed in the application. It ensure that text stands out effectively and maintains visual consistency across the application.
Font SizeSpecific font size, you can ensure that text appears clearly on the screen, and helps in emphasizing important information across various elements of the application.
Font StyleThe appearance of the text, such as bold, italic, or underline allows users to modify the style of the font to suit their preferences content within the application.

Security

The Security tab guarantees data security and privacy by implementing restricted access or encryption on sensitive field data. This ensures that only users with authorized roles can access or modify it. To know more about the fields that are available under the Security section, see Field Description given below. 

Figure: Security

Field Description

Field

Description

Restricted field access

Enable this option to ensure that specific roles have exclusive viewing or editing rights for the content within the Time Picker control, limiting access to authorized users only.

For Example

In Incident Management, select users have restricted access to modify specific fields like the 'Scheduled Completion Date.' When creating a new incident, they can choose a date using the Date Picker, ensuring critical dates are managed by authorized users.

Encrypted

Enabled this option to maintain the security and confidentiality of sensitive information by rendering it unreadable without the appropriate decryption key.

For Example

At NovaTech, HR personnel use a Date Picker tool linked to an encrypted field to securely input or view employee birthdates, ensuring compliance with data protection regulations.

For more information on Security details, refer Form Security.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.