Date Picker

Used to enable users to select a desired date within a month.

In progress
Show details
In progress
Published: January 08, 2025
Updated: December 11, 2025

DatePicker is used to select a desired date within a month. Currently, it does not cater to selecting date ranges.


Anatomy

Anatomy summary lists and describes all the elements within a component (including nested components).

datePicker-anatomy
  1. Field label: Mandatory textual label used to describe the form field to guide users in filling it.
  2. Field: Input element that allows users write in the date.
  3. Note (optional): Additional description helping users provide the right input, if the field label is insufficient.
  4. Icon: Calendar icon showcasing it’s a date-specific text field.
  5. Form Validation (optional): Text used when validating user form input to provide advice on fixing input errors and guiding expected input.
  6. Day/month toggle: Toggle used to change the view between choosing a day and a month.
  7. Popover: Container housing the date selection calendar.
  8. Previous/next month switch: Buttons used to navigate backwards and forwards between months.
  9. Day/month: Button representing a day or a month, depending on view preference.

Variants

Variants contain different versions of the component depending on specific properties, such as state, size, colour, optional iconography, etc.

DatePicker
DatePicker
state closed
DatePicker
DatePicker
state open

DatePicker has two main variants: closed and open, which control whether the calendar popover is visible. TextField states and functionality can be controlled directly in TextField component.


Component dependencies


Help and support