Date pickers
Date pickers let users select a date, or a range of dates.

Usage
Date pickers let users select a date or range of dates. They should be suitable for the context in which they appear.
Date pickers can be embedded into:
- Dialogs on mobile
- Text field dropdowns on desktop
Principles

Relevant
Date pickers can display past, present, or future dates – as relevant to the task.

Clear
Clearly indicate important dates, such as current and selected days.

Intuitive
To ensure picking a day or time is intuitive, use common picker patterns, such as a calendar.
Anatomy
Mobile calendar date picker

2. Selected date
3. Switch-to-keyboard input icon
4. Year selection menu
5. Month pagination
6. Current date
7. Selected date
Mobile date range picker

2. Selected date range
3. Switch to keyboard input icon
4. Month and year label
5. Current date
6. Start date
7. Selected range
8. End date
Mobile input picker

2. Selected date
3. Switch-to-calendar view icon
4. Text field
Desktop date picker

2. Year and month selection
3. Month pagination
4. Today’s date
5. Selected day
6. Hover state
Mobile pickers
Mobile calendar pickers
Usage
Mobile calendar pickers can be used to select dates in the near future or past, when it’s useful to see them in a calendar month format. They are displayed in a dialog.
Common use cases include:
- Making a restaurant reservation
- Scheduling a meeting
They aren’t ideal for selecting dates in the distant past or future that require more navigation, such as entering a birth date or expiration date.
Mobile calendar pickers allow selection of a single date and year.


Do

Don't

Don't
Behavior
Mobile calendar pickers navigate across dates in several ways:
- To navigate across months, swipe horizontally
- To navigate across years, scroll vertically
- To access the year picker, tap the year

Mobile date range pickers
Usage
Mobile date range pickers allow selection of a range of dates. They cover the entire screen.
Common use cases include:
- Booking a flight
- Reserving a hotel

Behavior
Mobile date range pickers navigate across dates in several ways:
- To select a range of dates, tap the start and end dates on the calendar
- To navigate across months, scroll vertically
Mobile date input pickers
Usage
Mobile date input pickers allow the manual entry of dates using the numbers on a keyboard. Users can input a date or a range of dates in a dialog.
Mobile date input picker
Mobile date input pickers allow for keyboard input to select a date or range of dates.


Do

Do
Behavior
The mobile date input picker can be accessed from any other mobile date picker, via the edit icon.
Desktop pickers
Desktop date pickers
Usage
Desktop date pickers allow the selection of a specific date and year. The desktop date picker displays a date input field by default, and a dropdown calendar appears when the user taps on the input field. The user can interact with either form of date entry.
Desktop date pickers are ideal for navigating dates in both the near future (or past) and the distant future (or past), as they provide multiple ways to select dates.

Behavior
Users can input dates either using a keyboard or by navigating the calendar UI; both options are immediately available when the desktop date picker is accessed.

Desktop date range pickers
Desktop date range pickers allow a range of days to be selected. They display both calendar and date input fields.

Do
Don't
Tooltips can help explain how to use date picker controls.

2. Tooltip on day selector
3. Tooltip used on month pagination control
4. Tooltip used on selected date
Theming
Pickers can be customized to express your brand identity by altering their layout, typography, shape, color, and motion.

2. Typography
3. Shape
4. Color
5. Motion
Color
Color can be used to create bold visual moments in a picker.

Shape
The shape indicating selection can be customized to match the degree of boldness desired, or align to a specific style.

2. The rectilinear custom shape
3. A rounded style for start and end dates and a different color for the dates in between the start and end dates help distinguish the selected period.
Layout
Date pickers span the full width of the screen.

Motion
Specs
Accessibility
On mobile, a date picker should allow users to enter dates manually by inputting text, without using the picker. This interaction allows multiple input methods and makes it accessible to those using assistive technology.
- On desktop, the text field can be used for input.
- On mobile, the input picker should be available from the calendar pickers via the edit icon.
Touch targets
Touch targets for mobile date pickers should be as large as possible, filling the available space. The minimum touch target size for a date picker is 32 x 32dp.


Mobile calendar picker
Calendar header

Padding
• Left and right: 24dp
• Menu bar top and bottom: 16dp
• Between month name and button: 4dp
• Between month pagination: 24dp
Baseline heights
• First baseline: 32dp from top
• Second baseline: 72dp from first baseline
• Third baseline: 32 dp from bottom of header
Element size
• Edit icon: 24 x 24dp
• Month dropdown button: 24 x 24dp
• Month pagination: 24 x 24dp
Calendar view

• Left and right padding: 12dp
• Date bounding box: 40 x 40dp
• Selected date: 36 x 36dp
• Padding between dates: 4dp
Year selection view

• Left and right margins: 24dp
• Year bounding box: 88 x 52 dp
• Selected year: 72 x 36dp
Mobile range picker

Padding
• Left and right padding: 12dp
• Padding between months: 4dp
• Edit icon padding: 16dp from right
Header
• Header height: 128dp
• Header text inset: 60dp from left margin
Baseline heights
• First baseline: 36dp from second baseline
• Second baseline: 24dp from bottom of header
• Third baseline (month name): 32dp from days of week
Element size
• Edit icon: 24 x 24dp
• Date bounding box: 48 x 48dp
• Selected date: 40 x 40dp
Mobile input picker

• Dimensions: 264 x 328dp
• Left and right padding: 24dp
Baseline heights
• First baseline: 28dp from top
• Second baseline: 72dp from first baseline
Element size
• Edit icon: 24 x 24 dp
• Text field: 16dp from bottom of header
• Text field height: 56dp
Desktop date picker
Calendar view

• Menu left padding: 24dp
• Menu right padding: 8dp
• Menu top padding: 16dp
• Menu bottom padding: 12dp
• Padding between month name and button: 4dp
• Padding between month pagination: 24dp
• Left and right padding of calendar area: 16dp
• Bottom padding: 8dp
Baseline heights
• First baseline: 32dp from top
• Second baseline: 36dp from first baseline
Element size
• Month dropdown button: 24 x 24dp
• Month pagination: 24 x 24dp
• Date bounding box: 32 x 32 dp
• Selected date: 28 x 28dp
Year selection view

• Left padding: 12dp
• Right padding: 20dp
• Bottom padding: 8dp
• Padding between menu and years: 4dp
Baseline height
• Menu height: 52dp
Element size
• Year bounding box: 56 x 32dp
• Selected year: 52 x 28dp
Desktop date range picker

• Left, right, and inside padding: 16dp
• Bottom padding: 8dp
• Month title baselines from top: 32dp
• Pagination arrows: 24 x 24dp