syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-datetimepicker
syncfusion-wpf-datetimepicker
VerifiedImplements the Syncfusion WPF DateTimeEdit (DateTimePicker) control for date and time selection with dropdown calendar/clock support. Use this when adding datetime pickers, masked datetime input, or datetime selection controls in WPF applications. Covers DateTime binding, mask/free-form editing, pattern formatting, CultureInfo localization, dropdown views, date range restrictions, blackout dates, null value handling, watermarks, and theming with SfSkinManager.
Implementing DateTimeEdit (WPF)
An enhanced date-time input control with mask editing, calendar/clock dropdown, date range restriction, formatting, and MVVM binding support.
When to Use This Skill
Use this skill when the user needs to:
- Add a date/time picker input field to a WPF application
- Bind a selected date to a ViewModel property (
DateTimetwo-way binding) - Format the displayed date/time (predefined patterns or custom patterns)
- Restrict selectable dates with min/max range or blackout dates
- Enable inline editing (mask mode or free-form text editing)
- Show a calendar, clock, or combined dropdown picker
- Display watermark text when no date is selected
- Handle null date values
- Apply locale-specific date formats via
CultureInfo - Localize dropdown button labels (Today/None)
Component Overview
| Class | Namespace | Assembly |
|---|---|---|
DateTimeEdit | Syncfusion.Windows.Shared | Syncfusion.Shared.WPF |
XAML Namespace:
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
NuGet:
Install-Package Syncfusion.Shared.WPF
Documentation and Navigation Guide
Getting Started
π Read: references/getting-started.md
- Assembly setup and XAML namespace
- Add via designer, XAML, or C#
- Setting
DateTimevalue - Two-way MVVM binding with
DateTimeChangedevent - Predefined
Patternquick reference MinDateTime/MaxDateTimebasics- SfSkinManager theme setup
DateTime Editing
π Read: references/datetime-editing.md
- Mask editing (default) β field-by-field input with auto-validation
- Keyboard navigation between date/time fields
- Free-form text editing (
CanEdit="True") - Mouse wheel value change (
EnableMouseWheelEdit) - Up/down repeat buttons (
IsVisibleRepeatButton,IsEnabledRepeatButton) - Custom repeat button UI templates
- Alpha key month navigation (
EnableAlphaKeyNavigation) - BackSpace/Delete key editing
OnFocusBehaviorandAutoForwardingfocus control
Formatting & Culture
π Read: references/formatting-and-culture.md
- All 11 predefined
Patternvalues CustomPatternwithPattern="CustomPattern"DateTimeFormatwithDateTimeFormatInfoCultureInfofor locale-specific formattingPatternChanged/CustomPatternChangedevents
Dropdown Popup
π Read: references/dropdown-popup.md
DropDownView: Calendar / Clock / Combined- Keyboard shortcuts (Alt+Down, F4)
TodayButtonAction(Date vs DateTime)IsEmptyDateEnabledβ None button / reset to nullAbbreviatedMonthNames/ShortestDayNamesPopupDelay,IsButtonPopUpEnabledDropDownButtonTemplatecustom UI- Custom calendar and clock (SfDateSelector / SfTimeSelector)
TimeStepIntervalfor clock
Date Restrictions & Null Values
π Read: references/date-restrictions.md
MinDateTime/MaxDateTimeβ prevent out-of-range selectionBlackoutDatesβ block specific date rangesDisableDateSelectionβ month/year onlyIsReadOnlyβ prevent all user editsNullValue/IsEmptyDateEnabled/ShowMaskOnNullValueNoneDateTextwatermark
Appearance
π Read: references/appearance.md
Foreground,Background,SelectionBrushFocusedBorderBrushFlowDirectionRTL- Repeat button background and margins
- SfSkinManager themes list
Localization
π Read: references/localization.md
CurrentUICulturesetup- Resource file naming:
Syncfusion.Shared.Wpf.{culture}.resx - Name/Value pairs for Today/None button labels
- French culture example
Quick Start Example
<!-- MainWindow.xaml -->
<Window xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
<Window.DataContext>
<local:ViewModel/>
</Window.DataContext>
<StackPanel HorizontalAlignment="Center" VerticalAlignment="Center">
<syncfusion:DateTimeEdit DateTime="{Binding SelectedDate, Mode=TwoWay}"
Pattern="ShortDate"
MinDateTime="01/01/2020"
MaxDateTime="12/31/2030"
Height="25" Width="200"
Name="dateTimeEdit"/>
</StackPanel>
</Window>
// ViewModel.cs
public class ViewModel : NotificationObject
{
private DateTime _selectedDate = DateTime.Now;
public DateTime SelectedDate
{
get => _selectedDate;
set { _selectedDate = value; RaisePropertyChanged(nameof(SelectedDate)); }
}
}
Common Patterns
| Scenario | Properties / Approach |
|---|---|
| Two-way date binding | DateTime="{Binding SelectedDate, Mode=TwoWay}" |
| Show calendar + clock | DropDownView="Combined" Pattern="FullDateTime" |
| Free-form text editing | CanEdit="True" |
| Date-only range restriction | MinDateTime="..." MaxDateTime="..." |
| Allow null / clear value | IsEmptyDateEnabled="True" NullValue="{x:Null}" ShowMaskOnNullValue="False" |
| Watermark when null | Add NoneDateText="Select a date" alongside null value properties |
| Custom date display | Pattern="CustomPattern" CustomPattern="dd-MMM-yyyy" |
| Culture-aware formatting | CultureInfo="fr-FR" Pattern="FullDateTime" |
| Read-only input | IsReadOnly="True" |
| RTL layout | FlowDirection="RightToLeft" |
| Apply theme | SfSkinManager.SetVisualStyle(dte, VisualStyles.FluentLight) |
Key Properties
| Property | Type | Default | Description |
|---|---|---|---|
DateTime | DateTime | DateTime.Now | Selected date/time value |
Pattern | DateTimePattern | ShortDate | Display format pattern |
CustomPattern | string | null | Custom format string (requires Pattern="CustomPattern") |
CultureInfo | CultureInfo | System culture | Locale for date formatting |
CanEdit | bool | false | Enable free-form text editing |
MinDateTime | DateTime | DateTime.MinValue | Minimum selectable date |
MaxDateTime | DateTime | DateTime.MaxValue | Maximum selectable date |
DropDownView | DropDownViews | Calendar | Popup content: Calendar/Clock/Combined |
IsEmptyDateEnabled | bool | false | Allow null date value |
NullValue | DateTime? | null | Value when date is cleared |
NoneDateText | string | "" | Watermark text when value is null |
ShowMaskOnNullValue | bool | true | Show mask vs watermark when null |
IsReadOnly | bool | false | Prevent user edits |
IsVisibleRepeatButton | bool | false | Show up/down spinner buttons |
EnableMouseWheelEdit | bool | true | Allow mouse wheel to change value |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |