Date Picker

Preview

About

Date selector that combines a text field (trigger) with an overlaid KasyCalendar. The trigger reuses KasyTextField in read-only mode, so it automatically inherits the design system's label, hint, suffix icon, padding, border, and shadow.

• value / onChanged: single date (single mode, default).
• range / onRangeChanged: start/end range (selectionMode: KasyDateSelectionMode.range) — this is how the catalog's DateRangePicker is built; there's no separate KasyDateRangePicker widget.
• presentation: popover (default on desktop), dialog, bottomSheet (default on phone/tablet). An explicit value always overrides the adaptive default.
• dateFormat: regional preset (us, southAmerican, european, iso, eastAsian); formatDate allows fully custom formatting and takes priority.
• locale: month names, weekday abbreviations, and default format (KasyDatePickerLocale.en/es/pt); follows the app's active language when omitted.
• minDate / maxDate: limits selectable dates.
• monthsToShow: months side by side (2 or 3) for wide layouts.
• variant: primary (default, white surface + soft shadow) or secondary ("filled" look, no shadow).
• label, showRequiredIndicator, description, errorText, isInvalid: same form fields as KasyTextField.
• showSuffix: shows/hides the calendar icon in the suffix.
• showBarrier: shows/hides the darkened scrim behind the popover.
• enabled: disables the entire field.

Last updated on 08/23/2026