Date pickers: Specs
Date pickers let people select a date, or a range of dates
Tokens & specs
Select a component variant below to see its elements, attributes, tokens, and their values.
Date picker - Docked
Date picker - Modal
Date picker - Modal input
Docked date picker

- Outlined text field
- Menu button: Month selection
- Menu button: Year selection
- Icon button
- Weekdays label text
- Unselected date
- Today’s date
- Outside month date
- Text buttons
- Selected date
- Container

- Outlined text field
- Menu button: Month selection (pressed)
- Menu button: Year selection (disabled)
- Header
- Menu
- Selected list item
- Unselected menu list item
- Container
Docked date picker color
Color values are implemented through design tokens. For design, this means working with color values that correspond with tokens. For implementation, a color value will be a token that references a value. Learn more about design tokens

Docked date picker color roles used for light and dark themes:
- Primary
- On surface variant
- On surface variant
- On surface
- On surface
- Primary
- On surface variant
- Primary
- Surface container high
- Primary
- On primary

Docked date picker menu color roles used for light and dark themes:
- Primary
- On surface variant
- On surface
- Outline variant
- Surface container high
- Surface variant
- On surface
Docked date picker measurements

Docked date picker padding and size measurements

Docked date picker month menu padding and size measurements
Docked date picker configurations

- Day selection
- Month selection
- Year selection
Modal date picker

- Headline
- Supporting text
- Header
- Container
- Icon button
- Icon buttons
- Weekdays
- Today’s date
- Unselected date
- Text buttons
- Selected date
- Menu button
- Divider

- Headline
- Supporting text
- Header
- Container
- Icon button
- Unselected year
- Selected year
- Text buttons
- Divider
- Menu button

- Headline
- Supporting text
- Icon button
- Header
- Text button
- Icon button
- Weekdays label text
- Container
- Today’s date
- Unselected date
- In-range active indicator
- In-range date
- Month subhead
- Selected date
- Divider
Modal date picker color
Color values are implemented through design tokens. For design, this means working with color values that correspond with tokens. For implementation, a color value will be a token that references a value. Learn more about design tokens

Modal date picker color roles used for light and dark themes in a day selection menu:
- On surface
- On surface variant
- Surface container high
- On surface variant
- On surface variant
- On surface
- Primary
- On surface
- Primary
- Primary
- On surface variant
- Outline variant

Modal date picker color roles used for light and dark themes in a year selection menu:
- On surface
- On surface variant
- Surface container high
- On surface variant
- On surface variant
- Primary
- Primary
- Outline variant
- On surface variant

Modal date picker range selector color roles used for light and dark themes:
- On surface
- On surface variant
- On surface variant
- Surface container high
- Primary
- On surface variant
- On surface
- Primary
- On surface
- Secondary container
- On secondary container
- Outline variant
- On surface variant
- Primary
Modal date picker measurements

Modal date picker padding and size measurements

Modal date picker year selector padding and size measurements

Modal date picker date range selector padding and size measurements
Modal date picker configurations

- Single date selection
- Date range selection
- Year selection
Modal date input

- Headline
- Supporting text
- Header
- Container
- Icon button
- Outlined text field
- Text buttons
- Divider
Modal date input color
Color values are implemented through design tokens. For design, this means working with color values that correspond with tokens. For implementation, a color value will be a token that references a value. Learn more about design tokens

Modal date input color roles used for light and dark themes:
- On surface
- On surface variant
- Surface container high
- On surface variant
- Primary
- Primary
- Outline variant
Modal date input measurements

Modal date input padding and size measurements
Modal date input configurations

- Single date input
- Date range input
Element states

States for date and year selection:
- Default (enabled)
- Disabled
- Hovered
- Focused
- Pressed (ripple)