DatePicker class

A picker control that lets users select a date.

The date picker provides a standardized way for users to pick a localized date value using touch, mouse, or keyboard input. It displays separate fields for month, day, and year that expand into scrollable lists.

{@tool snippet} This example shows a basic date picker:

DatePicker(
  selected: selectedDate,
  onChanged: (date) => setState(() => selectedDate = date),
  header: 'Select a date',
)

{@end-tool}

{@tool snippet} This example shows a date picker with restricted range:

DatePicker(
  selected: selectedDate,
  onChanged: (date) => setState(() => selectedDate = date),
  startDate: DateTime(2020, 1, 1),
  endDate: DateTime(2025, 12, 31),
)

{@end-tool}

Field configuration

Use showMonth, showDay, and showYear to show or hide specific fields. Use fieldOrder to customize the order of fields based on locale.

See also:

• TimePicker, for selecting time values
• CalendarDatePicker, for selecting dates from a calendar view
• CalendarView, for displaying and interacting with a calendar
• learn.microsoft.com/en-us/windows/apps/design/controls/date-picker