Implementing .NET MAUI Date Time Range Selector
The Syncfusion .NET MAUI Date Time Range Selector (SfDateTimeRangeSelector) is a highly interactive UI control that enables users to select a range of DateTime values within specified minimum and maximum limits. It's designed to work seamlessly with charts and other visual content, providing an intuitive way to filter and explore time-based data.
When to Use This Skill
Use this skill when user need to:
- Implement date/time range selection - Allow users to select a date or time range
- Filter chart data interactively - Enable users to zoom or filter charts by selecting time periods
- Create time period selectors - Build UI for selecting quarters, months, weeks, or custom periods
- Add range sliders for dates - Implement slider controls that work with DateTime values
- Build data exploration tools - Create interactive controls for analyzing time-series data
- Customize range selector appearance - Style labels, ticks, thumbs, tracks, and regions
- Handle range selection events - Respond to user interactions with range changes
- Integrate with charts - Embed Syncfusion Charts or other content within the range selector
Component Overview
- DateTime range selection with draggable thumbs
- Chart content integration for data visualization
- Customizable labels, ticks, and dividers
- Discrete selection with step intervals
- Tooltip support with custom formatting
- Rich styling options for all visual elements
- Region highlighting (active/inactive areas)
- Multiple drag behaviors
- Event-driven architecture with commands
- Liquid Glass effect for modern UI (iOS 26+, macOS 26+)
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- NuGet package installation (
Syncfusion.Maui.Sliders)
- Handler registration (
ConfigureSyncfusionCore)
- Basic DateTime Range Selector implementation
- Adding chart content
- Minimum, Maximum, RangeStart, RangeEnd configuration
Interval and Formatting
📄 Read: references/interval-and-formatting.md
- Date interval configuration (
Interval, IntervalType)
- Interval types (Years, Months, Days, Hours, Minutes, Seconds)
- Auto interval calculation
- Date format patterns (
DateFormat property)
- Custom interval scenarios
Labels Configuration
📄 Read: references/labels.md
- Enabling labels (
ShowLabels)
- Date format customization
- Label placement (
LabelsPlacement: OnTicks, BetweenTicks)
- Edge labels placement (
EdgeLabelsPlacement)
- Label styling (colors, fonts, sizes for active/inactive)
- Label offset customization
- Custom label text via
LabelCreated event
Ticks and Dividers
📄 Read: references/ticks-and-dividers.md
- Major ticks configuration (
ShowTicks)
- Minor ticks (
MinorTicksPerInterval)
- Tick styling (colors, sizes, offsets)
- Dividers display (
ShowDividers)
- Divider customization (radius, colors, strokes)
- Active/inactive tick states
Track and Regions
📄 Read: references/track-and-regions.md
- Track properties (Minimum, Maximum, range values)
- Track color customization (active/inactive)
- Track height (
ActiveSize, InactiveSize)
- Track extent configuration
- Region fill and stroke colors
- Region stroke thickness
- Active/inactive region differentiation
Thumb and Overlay
📄 Read: references/thumb-and-overlay.md
- Thumb size configuration (
Radius)
- Thumb fill and stroke colors
- Thumb overlap handling (
OverlapStroke)
- Thumb overlay customization
- Overlay size and colors
- Interactive visual feedback
Tooltips
📄 Read: references/tooltip.md
- Enabling tooltips
- ShowAlways mode for persistent display
- Tooltip styling (fill, stroke, padding)
- Text customization (color, font, size)
- Date format in tooltips
- Custom tooltip text via
TooltipLabelCreated event
Selection and Interaction
📄 Read: references/selection-and-interaction.md
- Discrete selection (
StepDuration)
- Interval selection mode (
EnableIntervalSelection)
- Drag behaviors (OnThumb, BetweenThumbs, Both)
- Deferred updates (
EnableDeferredUpdate, DeferredUpdateDelay)
- Touch and mouse interaction
- IsInversed property
Events and Commands
📄 Read: references/events-and-commands.md
- ValueChangeStart/End events
- ValueChanging event with
DateTimeRangeSelectorValueChangingEventArgs
- ValueChanged event with
DateTimeRangeSelectorValueChangedEventArgs
- LabelCreated and TooltipLabelCreated events
- DragStartedCommand and DragCompletedCommand
- Command parameters
- MVVM pattern implementation
Advanced: Liquid Glass Effect
📄 Read: references/liquid-glass-effect.md
- Modern translucent glass-like UI effect
EnableLiquidGlassEffect property- Platform requirements (.NET 10, iOS 26+, macOS 26+)
- Visual design principles
- Implementation examples
1---2name: syncfusion-maui-date-time-range-selector3description: Implements Syncfusion .NET MAUI DateTime Range Selector (SfDateTimeRangeSelector) for interactive date/time range selection with chart integration. Use when working with range selectors, date range pickers, time range selection, chart range filtering, or interactive range controls. Covers range selection UI, filtering chart data by date range, and selecting time periods.4---5
6# Implementing .NET MAUI Date Time Range Selector
7
8The Syncfusion .NET MAUI Date Time Range Selector (`SfDateTimeRangeSelector`) is a highly interactive UI control that enables users to select a range of DateTime values within specified minimum and maximum limits. It's designed to work seamlessly with charts and other visual content, providing an intuitive way to filter and explore time-based data.
9
10## When to Use This Skill
11
12Use this skill when user need to:
13
14- **Implement date/time range selection** - Allow users to select a date or time range
15- **Filter chart data interactively** - Enable users to zoom or filter charts by selecting time periods
16- **Create time period selectors** - Build UI for selecting quarters, months, weeks, or custom periods
17- **Add range sliders for dates** - Implement slider controls that work with DateTime values
18- **Build data exploration tools** - Create interactive controls for analyzing time-series data
19- **Customize range selector appearance** - Style labels, ticks, thumbs, tracks, and regions
20- **Handle range selection events** - Respond to user interactions with range changes
21- **Integrate with charts** - Embed Syncfusion Charts or other content within the range selector
22
23## Component Overview
24
25- DateTime range selection with draggable thumbs
26- Chart content integration for data visualization
27- Customizable labels, ticks, and dividers
28- Discrete selection with step intervals
29- Tooltip support with custom formatting
30- Rich styling options for all visual elements
31- Region highlighting (active/inactive areas)
32- Multiple drag behaviors
33- Event-driven architecture with commands
34- Liquid Glass effect for modern UI (iOS 26+, macOS 26+)
35
36## Documentation and Navigation Guide
37
38### Getting Started
39📄 **Read:** [references/getting-started.md](references/getting-started.md)
40- NuGet package installation (`Syncfusion.Maui.Sliders`)
41- Handler registration (`ConfigureSyncfusionCore`)
42- Basic DateTime Range Selector implementation
43- Adding chart content
44- Minimum, Maximum, RangeStart, RangeEnd configuration
45
46### Interval and Formatting
47📄 **Read:** [references/interval-and-formatting.md](references/interval-and-formatting.md)
48- Date interval configuration (`Interval`, `IntervalType`)
49- Interval types (Years, Months, Days, Hours, Minutes, Seconds)
50- Auto interval calculation
51- Date format patterns (`DateFormat` property)
52- Custom interval scenarios
53
54### Labels Configuration
55📄 **Read:** [references/labels.md](references/labels.md)
56- Enabling labels (`ShowLabels`)
57- Date format customization
58- Label placement (`LabelsPlacement`: OnTicks, BetweenTicks)
59- Edge labels placement (`EdgeLabelsPlacement`)
60- Label styling (colors, fonts, sizes for active/inactive)
61- Label offset customization
62- Custom label text via `LabelCreated` event
63
64### Ticks and Dividers
65📄 **Read:** [references/ticks-and-dividers.md](references/ticks-and-dividers.md)
66- Major ticks configuration (`ShowTicks`)
67- Minor ticks (`MinorTicksPerInterval`)
68- Tick styling (colors, sizes, offsets)
69- Dividers display (`ShowDividers`)
70- Divider customization (radius, colors, strokes)
71- Active/inactive tick states
72
73### Track and Regions
74📄 **Read:** [references/track-and-regions.md](references/track-and-regions.md)
75- Track properties (Minimum, Maximum, range values)
76- Track color customization (active/inactive)
77- Track height (`ActiveSize`, `InactiveSize`)
78- Track extent configuration
79- Region fill and stroke colors
80- Region stroke thickness
81- Active/inactive region differentiation
82
83### Thumb and Overlay
84📄 **Read:** [references/thumb-and-overlay.md](references/thumb-and-overlay.md)
85- Thumb size configuration (`Radius`)
86- Thumb fill and stroke colors
87- Thumb overlap handling (`OverlapStroke`)
88- Thumb overlay customization
89- Overlay size and colors
90- Interactive visual feedback
91
92### Tooltips
93📄 **Read:** [references/tooltip.md](references/tooltip.md)
94- Enabling tooltips
95- ShowAlways mode for persistent display
96- Tooltip styling (fill, stroke, padding)
97- Text customization (color, font, size)
98- Date format in tooltips
99- Custom tooltip text via `TooltipLabelCreated` event
100
101### Selection and Interaction
102📄 **Read:** [references/selection-and-interaction.md](references/selection-and-interaction.md)
103- Discrete selection (`StepDuration`)
104- Interval selection mode (`EnableIntervalSelection`)
105- Drag behaviors (OnThumb, BetweenThumbs, Both)
106- Deferred updates (`EnableDeferredUpdate`, `DeferredUpdateDelay`)
107- Touch and mouse interaction
108- IsInversed property
109
110### Events and Commands
111📄 **Read:** [references/events-and-commands.md](references/events-and-commands.md)
112- ValueChangeStart/End events
113- ValueChanging event with `DateTimeRangeSelectorValueChangingEventArgs`
114- ValueChanged event with `DateTimeRangeSelectorValueChangedEventArgs`
115- LabelCreated and TooltipLabelCreated events
116- DragStartedCommand and DragCompletedCommand
117- Command parameters
118- MVVM pattern implementation
119
120### Advanced: Liquid Glass Effect
121📄 **Read:** [references/liquid-glass-effect.md](references/liquid-glass-effect.md)
122- Modern translucent glass-like UI effect
123- `EnableLiquidGlassEffect` property
124- Platform requirements (.NET 10, iOS 26+, macOS 26+)
125- Visual design principles
126- Implementation examples
127
gabrielmoreira