Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Date pickers: Guidelines ​

Date pickers let people select a date, or a range of dates


A date picker opens in a form UI.
Docked date picker on desktop

Usage ​

Date pickers let people select a date or range of dates. They should be suitable for the context in which they appear.

Date pickers can be embedded into:

  1. DialogsDialogs provide important prompts in a user flow.More on dialogs on compact breakpoints like mobile
  2. Text fieldText fields let users enter text into a UI.More on text fields drop-downs on medium and expanded breakpointsWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints like tablet and desktop
2 date picker variations: a dialog on mobile and a dropdown within a text field on desktop.
  1. Date picker dialog on mobile
  2. Date picker text field dropdown on desktop

There are three variants of date pickers:

  1. Docked date picker
  2. Modal date picker
  3. Modal date input
A docked date picker component.
1. Docked date picker
A modal date picker component.
2. Modal date picker
A modal date input component.
3. Modal date input

Anatomy ​

Docked date picker ​

7 elements of a docked date picker.
  1. Text field
  2. Menu button
  3. Icon button
  4. Label text
  5. Menu
  6. Text buttons
  7. Container
3 elements of a docked date picker.
  1. Text field
  2. Menu button
  3. Menu

Modal date picker ​

12 elements of a modal date picker.
  1. Headline
  2. Supporting text
  3. Container
  4. Icon button
  5. Previous/next month buttons
  6. Day of week labels
  7. Today’s date
  8. Unselected date
  9. Text buttons
  10. Selected date
  11. Menu button
  12. Divider
9 elements of a modal date picker.
  1. Headline
  2. Supporting text
  3. Container
  4. Icon button
  5. Unselected year
  6. Selected year
  7. Text buttons
  8. Divider
  9. Menu button

Modal date input ​


7 elements of a modal date input.
  1. Headline
  2. Supporting text
  3. Container
  4. Icon button
  5. Date input
  6. Text buttons
  7. Divider

Full-screen date picker ​


14 elements of a full-screen date picker.
  1. Headline
  2. Supporting text
  3. Icon button
  4. Container
  5. Text button
  6. Icon button
  7. Divider
  8. Day of week labels
  9. Today’s date
  10. Selected date range
  11. Unselected date
  12. Text buttons
  13. Selected date range start date
  14. Month label

Docked date picker ​

Usage

Docked date pickers allow the selectionSelection lets users choose specific items to act on.More on selection of a specific date and year. The docked date picker displays a date inputInputs are devices that provide interactive control of an app. Common inputs are a mouse, keyboard, and touchpad. field by default, and a dropdown calendar appears when the user taps on the input field. Either form of date entry can be interacted with.

Docked 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.

Docked date picker on a desktop screen.
Docked date picker on desktop

Behavior

Dates can be added by using a keyboard or by navigating the calendar UI; both options are immediately available when the docked date picker is accessed.

Docked date picker with a text field and the UI picker showing the selected date.
Docked date picker
Docked date pickers adjust size dynamically
The year selection menu replaces the calendar view

Month selection

Month selectionSelection lets users choose specific items to act on.More on selection can be navigated with the corresponding back and next arrows or by tapping the dropdown menu.

Docked date picker with a list of months May through September. August is selected.
Docked date picker month selection

Year selection

Year selection can be navigated with the corresponding back and next arrows or by tapping the dropdown menu.

Docked date picker with a list of years 2025 to 2029. 2025 is selected.
Docked date picker year selection

Modal date picker ​

Behavior ​

Modal date 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

Don’t use a modal date picker to prompt for dates in the distant past or future, such as a date of birth. In these cases, use a modal input picker or a docked date picker instead.

To navigate across months, swipe horizontally
To navigate across years, tap the year picker and scroll vertically

Date range selection ​

Date range selection provides a start and end date. Common use cases include:

  • Booking a flight
  • Reserving a hotel

Modal date pickers navigate across date ranges in several ways:

  • To select a range of dates, tap the start and end dates on the calendar
  • To navigate across months, scroll vertically
Modal date range picker
Modal date range picker with vertical scroll

Modal date input ​

Usage

Modal date inputs allow the manual entry of dates using the numbers on a keyboard. People can input a date or a range of dates in a dialog.

A modal date input component.
Modal date with manual input
A modal date input component showing a day in 1979, which would be difficult to choose using UI.
Do For dates that don’t require a calendar view, the modal date input can be the default view
A modal date input with hint text for entering the date.
Do Alternatively, a text field with appropriate hint text can prompt for dates, such as in a form

Behavior ​

You can swap between the modal date pickerModal date pickers extend full-screen. They're often used for selecting a date range.More on modal date pickers and modal date inputModal date inputs allow the manual entry of dates using the numbers on a keyboard. They're often used in compact layouts.More on modal date inputs using the edit or calendar icon.

Switching from a modal date picker to a mobile date input for selecting ranges
Switching from a modal date picker to a modal date input for selecting a single date

Compact breakpoint

On compact breakpoints, such as mobile, a full-screen modal date pickerModal date pickers extend full-screen. They're often used for selecting a date range.More on modal date picker is recommended to increase readability and touch target size. It can cover the entire screen.

A full-screen view of modal date picker on a mobile device.
A full-screen modal date picker on mobile

Medium and expanded breakpoints

The docked date picker works best for medium and expanded breakpoints. It displays a date input field by default, and a dropdown calendar appears when a person taps on the input field. A person can interact with either form of date entry.

Docked date pickers are ideal for navigating dates in both the near future or past, and in the distant future or past, as they provide multiple ways to select dates.

A docked date picker displaying a full calendar view on a large screen device.
A docked date picker with a full calendar view is best used on larger devices

Selection

Selection is indicated through color, drawing visual attention. In date ranges, start and end dates are selected, while dates in-between appear connected with a subtle highlight.

Differences between selected the selected date range (August 17–23) and today's date (August 5) are shown through color and fill

Appearing and disappearing ​

Like other kinds of dialogs, modal date pickers use an enter and exit transition pattern to appear on the screen.

To exit a date picker, the input can either be confirmed (OK) or dismissed (Cancel). Interacting outside of the dialog will also dismiss the time pickerTime pickers help users select and set a specific time.. Unless one of these actions is taken, a time picker will continue to retain focus. Mobile full-screen pickers also have an additional close affordance (x) icon button and Save confirmation.

Docked date pickers appear just below the input field.

Modal date pickers can be dismissed through interacting with content outside the dialog, or with the action buttons in the lower right
Interacting with the input for a docked date picker makes the calendar view appear below

Responsive layout

The sizing of the docked and modal date picker components don’t scale responsively to different breakpoints.

Docked date picker enlarged on a large screen responsively.
Don't Don’t scale the date picker responsively to a larger size
Pager
Previous pageDate pickers: Specs
Next pageDate pickers: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/date-pickers/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google