Ready

Date Picker

Date picker allows users select a date, or a range of dates. The date picker displays a date input field by default, and a dropdown calendar appears when the user taps on the input field.

Ready

Date Picker

Date picker allows users select a date, or a range of dates. The date picker displays a date input field by default, and a dropdown calendar appears when the user taps on the input field.

Ready

Date Picker

Date picker allows users select a date, or a range of dates. The date picker displays a date input field by default, and a dropdown calendar appears when the user taps on the input field.

Anatomy

Anatomy

Anatomy

  1. Input

  2. Calendar

Variants

Variants

Variants

  1. Default: Uses a single calendar

  2. Range: Uses a Range Calendar or a Range Calendar with Presets

States

States

States

  1. Default

  2. Focus

  3. Hover

  4. Disabled

  5. Locked

  6. Error

Behaviors

Behaviors

Behaviors

Month & Year Selectors

Month and year selectors allow users to navigate or select across large date ranges more easily.

  1. Month Select

  2. Year Select

Auto Formatting

If a date is entered using alternate separators, the date will be auto formatted to use "/" instead.

Best Practices

Best Practices

Best Practices

1. Default Month

Date picker should default to the month of the current selection. Setting random values for the user will introduce extra work and increase the interaction cost.

2. Dismissal

When selecting a single day, the Calendar should automatically disappear once a date is selected.

3. Illogical Date Options

Date picker should eliminate illogical date options to reduce human error. For instance, the date picker should not allow users to enter a campaign end date before the start date.

4. Errors

Date picker should report errors appropriately. If user enters an invalid date, the input field should give user feedback and provide the correct format.

5. Typing

Allow user to type the date. Typing the date is the most basic option for date input, especially when the date is further away in the past. It is the most effective way to allow users to type the date.

More

More

More

Related Components

Accessibility

Color contrast ratio for our Date Pickers meets AA standards, based on Web Content Accessibility Guidelines (WCAG) guidelines.

  1. Benefits: People with low vision often have difficulty reading text that does not contrast with its background. This can be exacerbated if the person has a color vision deficiency that lowers the contrast even further. Providing a minimum luminance contrast ratio between the text and its background can make the text more readable even if the person does not see the full range of colors. It also works for the rare individuals who see no color.

Additional Reading

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

© 2025 Basis Technologies
© 2025 Basis Technologies
© 2025 Basis Technologies