Date & Time

Assembly: TheTechIdea.Beep.WPF.Controls · XAML namespace: xmlns:beep="clr-namespace:TheTechIdea.Beep.WPF.Controls;assembly=TheTechIdea.Beep.WPF.Controls"

BeepCalendar

A themed month calendar that can bind external events onto its display.

Base type: System.Windows.Controls.Calendar. Standard Calendar members (SelectedDate, DisplayDate, DisplayMode) are inherited.

Property	Type	Description
BorderRadius	CornerRadius	Corner radius of the calendar chrome.
Content	object	Optional content overlaid on the calendar (added-owner of `ContentControl.Content`).
EventsSource	IEnumerable	External collection of business objects to project onto the calendar as events; observed for changes when `AutoRefresh` is on.
EventConverter	Func<object, CalendarEvent>	Converts each source item into a `CalendarEvent`; nothing is bound until this is set.
AutoRefresh	bool	When true (default), re-binds automatically as the observed `EventsSource` collection changes.

<beep:BeepCalendar EventsSource="{Binding Appointments}"
                   EventConverter="{Binding ToCalendarEvent}"
                   BorderRadius="8"/>

BeepDatePicker

A single-date picker with placeholder text and validation support.

Base type: System.Windows.Controls.DatePicker, implements IBeepValidatable. SelectedDate, SelectedDateFormat and DisplayDate are inherited.

Property	Type	Description
PlaceholderText	string	Hint text shown when no date is selected.
ComponentName	string	Logical name used in validation messages.
IsRequired	bool	When true, validation fails if no date is selected.
IsEditable	bool	Whether the field accepts user input (default true).
ToolTipText	string	Tooltip text for the control.
HasError	bool	True when the control is in an error state.
ValidationError	string	Current validation error message.

<beep:BeepDatePicker PlaceholderText="Start date"
                     IsRequired="True"
                     SelectedDate="{Binding StartDate}"/>

BeepDateDropDown

A date drop-down that reuses the themed combo shell — a date value chosen from a drop-down list.

Base type: BeepComboBox, implements IBeepThemeable. It defines no new dependency properties of its own — it inherits the combo template (toggle + popup + SimpleItem rows) and members such as ListItems, SelectedItem and PlaceholderText from BeepComboBox; its skin style is a one-line BasedOn the BeepComboBox style.

<beep:BeepDateDropDown ListItems="{Binding DateOptions}"
                       SelectedItem="{Binding ChosenDate}"
                       PlaceholderText="Pick a date"/>

BeepDateTimePicker

A combined date-and-time editor.

Base type: ContentControl (templated).

Property	Type	Description
SelectedDate	DateTime?	Selected date/time; bound TwoWay to the embedded date editor.

<beep:BeepDateTimePicker SelectedDate="{Binding When}"/>

BeepDateRangePicker

A start/end date-range selector.

Base type: UserControl, implements IBeepThemeable. It exposes the ControlStyle and Theme chrome hooks and defines no additional dependency properties of its own.

<beep:BeepDateRangePicker beep:BeepChrome.ControlStyle="Material3"/>

BeepTimePicker

A time-of-day editor that parses its text into a TimeSpan.

Base type: ContentControl (templated). The read-only SelectedTime (TimeSpan?) property returns the parsed value of Text, or null when it is not a valid time.

Property	Type	Description
Text	string	Time-entry text bound TwoWay to the embedded editor (e.g. "14:30").

<beep:BeepTimePicker Text="{Binding MeetingTime}"/>