NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3053 most downloaded on pub.dev
This package includes a suite of Cupertino-style components that make date and time selection seamless and visually consistent with iOS design principles.
Last release 8 days ago
30 Sep 2026
Ships unpredictably
gaps range from 1 weeks to 1.2 years
Nearly every release is documented
notes for 26 of 26 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
26 releases · first in 2024
Migrated to the standalone cupertino_ui and material_ui packages; apps must migrate as well (see the migration guide ). The flutter_localizations depe
cupertino_ui and material_ui packages; apps must migrate as well (see the migration guide). The flutter_localizations dependency was removed; use GlobalMaterialLocalizations.delegates from material_ui.3.47.0 and Dart 3.13.0.onOusideTapOrDateSelect, hasOusideTapDismiss and transparentAndBlured are now onOutsideTapOrDateSelect, hasOutsideTapDismiss and transparentAndBlurred.CancelCupertinoCalendarAction.onPressed is a VoidCallback and ConfirmCupertinoCalendarAction.onPressed is a ValueChanged<DateTime>. onPressed was removed from the CupertinoCalendarAction base class, and a cancel action never equals a confirm action.'Cancel' and 'Done'. CupertinoCalendarAction.label is nullable; use effectiveLabel to get the displayed label.widgetRenderBox of showCupertinoCalendarPicker and showCupertinoTimePicker is optional; without it the picker is centered.CupertinoColors.systemRed when no mainColor is given.horizontalSpacing and verticalSpacing for CupertinoCalendarPickerButton and CupertinoTimePickerButton.CupertinoCalendarAction and CalendarButtonFormatter.const constructors for CupertinoCalendar and CalendarMonthPickerDecoration.CalendarDismissBehavior.onActionTap asserts that at least one action is provided.null. With a confirm action, closing the picker in any other way returns null. CupertinoCalendarPickerButton now displays the confirmed date.offset. It keeps offset from its anchor and is centered on the screen when it would otherwise shrink below half of its size.minimumDateTime...maximumDateTime in all widgets, including when the range changes; this also fixes an assertion when today is outside of the range. The AM/PM switcher, the year picker and times that are not a multiple of minuteInterval no longer produce invalid values.minimumDateTime or maximumDateTime moves the selection into the range, CupertinoCalendar, CupertinoCalendarPickerButton and CupertinoTimePickerButton report it through onDateTimeChanged/onTimeChanged, and the displayed month no longer jumps.CupertinoCalendarPickerButton and CupertinoTimePickerButton no longer fill the whole width of their parent.CupertinoCalendar outside of an overlay no longer pop the hosting route, and the picker no longer closes a route pushed on top of it.copyWith keeps the values that were not passed, and dynamic colors adapt to dark mode in all decorations, including PickerContainerDecoration. PickerContainerDecoration.withDynamicColor now only limits the opacity of a custom color instead of raising it.下午 3:07), one-letter weekdays are no longer repeated in Chinese and Arabic, and the chevrons are mirrored in right-to-left layouts.One column per month.
Added selectableDayPredicate callback parameter to the calendar, allowing certain dates to be disabled. (Thanks to @Menelphor )
selectableDayPredicate callback parameter to the calendar, allowing certain dates to be disabled. (Thanks to @Menelphor)Added useRootNavigator parameter to dialog functions and buttons, allowing to disable the root navigator for displaying the picker. (Thanks to @pablod
useRootNavigator parameter to dialog functions and buttons, allowing to disable the root navigator for displaying the picker. (Thanks to @pablodekeyzer)Fixed an issue with wrong weekday generation caused by daylight saving time differences. (Thanks to @vixez )
Fixed an issue where xAlignment was calculated incorrectly when the CupertinoCalendarPicker downscaled because of the lack of space. (Thanks to @maxfr
xAlignment was calculated incorrectly when the CupertinoCalendarPicker downscaled because of the lack of space. (Thanks to @maxfrees)CupertinoCalendarPicker and CupertinoPickerButton widgets. (Thanks to @ervindobri)fontSize for CalendarMonthPickerSelectedDay and CalendarMonthPickerSelectedCurrentDay has been decreased from 22.0 to 20.0.Fixed an issue when setState was called after the CupertinoPickerButton was disposed. (Thanks to @nightmre789 )
setState was called after the CupertinoPickerButton was disposed. (Thanks to @nightmre789)The intl package version constraint has been updated to the range >=0.19.0 <0.21.0 . (Thanks to @KoheiKanagu )
intl package version constraint has been updated to the range >=0.19.0 <0.21.0. (Thanks to @KoheiKanagu)intl package version constraint has been updated to the range >=0.19.0 <0.21.0. (Thanks to @KoheiKanagu)Added CupertinoCalendarAction list to the CupertinoCalendar widget, allowing to display actions at the bottom of the calendar.
CupertinoCalendarAction list to the CupertinoCalendar widget, allowing to display actions at the bottom of the calendar.CalendarDismissBehavior.onActionTap allowing to dismiss the calendar only when an action is tapped.Added firstDayOfWeekIndex parameter to calendar widgets, allowing customization of the starting day of the week. If not specified, the locale's defaul
firstDayOfWeekIndex parameter to calendar widgets, allowing customization of the starting day of the week. If not specified, the locale's default value is used.Added onCompleted callback to CupertinoCalendarPickerButton and CupertinoTimePickerButton . (Thanks to @MrLightful )
onCompleted callback to CupertinoCalendarPickerButton and CupertinoTimePickerButton. (Thanks to @MrLightful)v3.24.0.v3.2.0.Updated the scaleAlignment calculation for the X-axis.
scaleAlignment calculation for the X-axis.Thanks to @desarrolladorits2 for the following changes:
dayPeriodTextStyle property has been added to the CalendarFooterDecoration class.Fixed scrolling behavior in Date/Time pickers when using a mouse on Desktop and Web platforms. (Thanks to @klondikedragon)
Removed redundant assertions for currentDateTime. (Thanks to @danielshuk)
currentDateTime. (Thanks to @danielshuk)CustomCupertinoDatePicker was updated to use the version introduced in Flutter 3.27.0
CustomCupertinoDatePicker was updated to use the version introduced in Flutter 3.27.0a getter was replaced by alpha to maintain compatibility with the current minimum SDK version.withOpacity method was replaced by withAlpha due to deprecation.
intl package is now being used for date and time formatting.withOpacity method was replaced by withAlpha due to deprecation.use24hFormat param has been added to all widgets. (Thanks to @sargntpi)
use24hFormat param has been added to all widgets. (Thanks to @sargntpi)dismissBehavior param has been added to the CupertinoCalendarPickerButton widget.New showCupertinoTimePicker function which can be used for time selection.
Major Updates:
showCupertinoTimePicker function which can be used for time selection.CupertinoCalendarPickerButton widget.CupertinoTimePickerButton widget.CupertinoCalendar widget. Which is now can be used as inline calendar.CupertinoCalendarMode parameter with date and dateTime options, enabling the calendar to select both date and time within the picker.Minor Updates:
CupertinoCalendarPicker updates:monthDateStyle is now animated when switching between the month/year picker and month picker modes.Breaking Changes:
CalendarContainerDecoration has been renamed to PickerContainerDecoration.CalendarBackgroundType has been renamed to PickerBackgroundType.dismissBehaviour has been renamed to dismissBehavior.minimumDate has been renamed to minimumDateTime.maximumDate has been renamed to maximumDateTime.initialDate has been renamed to initialDateTime.currentDate has been renamed to currentDateTime.onDateChanged has been renamed to onDateTimeChanged.* README update.
README update.The CalendarDismissBehavior enum was added to specify different dismiss behaviors.
CalendarDismissBehavior enum was added to specify different dismiss behaviors.onDateSelected parameter was added.showCupertinoCalendarPicker function now returns a DateTime.Fixed an issue where safeArea top wasn't considered in the position calculation.
safeArea top wasn't considered in the position calculation.CalendarContainerDecoration wasn't applied to the calendar.Updates to the CupertinoCalendarPicker position calculation:
CupertinoCalendarPicker position calculation:
safeArea is now considered in the calculation.verticalSpacing is now considered in the calculation.showCupertinoCalendarPicker:
verticalSpacing to set the minimum space between the edge of the screen and the calendar.barrierColor for the overlay background color.CalendarContainerDecoration class:
boxShadow has been updated.CalendarBackgroundType enum added with plainColor and transparentAndBlured values.innerAlignment of the calendar is always topCenter now.cupertino_icons dependency added
cupertino_icons dependency addedwidgetRenderBox is required nowpubspec screenshots updateDecoration classes updated (copyWith, documentation)
pubspec update* README fix * pubspec update
README fixpubspec updateThe cupertino calendar package release.
145
likes
160
points
10.1k
downloads
API reference
philip-softworks.dev
This package includes a suite of Cupertino-style components that make date and time selection seamless and visually consistent with iOS design principles.
Repository (GitHub)
View/report issues
#cupertino #calendar-picker #ios #time-picker #widget
BSD-3-Clause, MIT ( license )
cupertino_icons , cupertino_ui , flutter , intl , material_ui
Packages that depend on cupertino_calendar_picker
145
likes
160
points
10.1k
downloads
API reference
philip-softworks.dev
This package includes a suite of Cupertino-style components that make date and time selection seamless and visually consistent with iOS design principles.
Repository (GitHub)
View/report issues
#cupertino #calendar-picker #ios #time-picker #widget
BSD-3-Clause, MIT ( license )
cupertino_icons , cupertino_ui , flutter , intl , material_ui
Packages that depend on cupertino_calendar_picker
Back
Your coding agent can read these notes before it upgrades. Set up the MCP server →